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This version of the SuperBrain Users Manual is intended for use with the SuperBrain II 
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This equipment complies with the requirements in Part 15 of FCC Rules for a Class A 
computing device. Operation of this equipment in a residential area may cause unac- 
ceptable interference to radio and TV reception requiring the operator to take 
whatever steps are necessary to correct the interference. 
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CONGRATULATIONS ON YOUR PURCHASE OF INTERTEC'S SUPERBRAIN II 

VIDEO COMPUTER SYSTEM 



Your new SuperBrain II Video Computer was manufactured at Intertec's new 1 20,000 square foot 
plant in Columbia, South Carolina, under stringent quality control procedures to insure trouble- 
free operation for many years. If you should encounter difficulties with the use or operation of 
your terminal, contact the dealer from whom the unit was purchased for instructions regarding 
the proper servicing techniques. If service cannot be made available through your dealer, 
contact Intertec's Customer Services Department at (803) 798-9100. 

As with all Intertec products, we would appreciate any comments you may have regarding your 
evaluation and application of this equipment. For your convenience, we have enclosed a 
customer comment card at the end of this manual. Please address your comments to: 

Product Services Manager 
Intertec Data Systems Corporation 

2300 Broad River Road 
Columbia, South Carolina 29210 

The SuperBrain II is distributed worldwide through a network of dealer/OEM vendors and through 
Intertec's own marketing facilities. Contact us at (803) 798-9100 (TWX — 810-666-2115) 
regarding your requirement for this and other Intertec products. 





SYSTEMS* 

Corporate Headquarters: 2300 Broad River Road, Columbia, Soutii Carolina 29210 • 803/798-9100 • TWX: 810-666-21 15 
Intertec's new one hundred and twenty thousand square foot corporate and manufacturing facility in Columbia, South Carolina 
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WILL THE MICROCOMPUTER YOU BUY TODAY 
STILL BE THE BEST MICROCOMPUTER BUY TOMORROW? 



Probably the best test in determining how to spend your microcomputer dollar wisely is to 
consider the overall versatility of your terminal purchase over the next three to five years. In the 
fast-paced, ever-changing world of data communications, new features to increase operator and 
machine efficiency are introduced into the marketplace daily. We at Intertec are acutely aware of 
this rapid infusion of new ideas into the small systems business. As a result, we have designed 
the SuperBrain II in such a manner as to virtually eliminate the possibility of obsolescence. 

Many competitive alternatives to the SuperBrain II available today provide only limited capability 
for high level programming and system expansion. Indeed, most low-cost microcomputer 
systems presently available quickly become outdated because of the inability to expand the 
system. Intertec, however, realizes that increased demands for more efficient utilization of 
programming makes system expansion capability mandatory. That means a lot. Because the 
more you use your SuperBrain II, the more you'll discover its adaptability to virtually any small 
system requirement. Extensive use of "software-oriented" design concepts instead of 
conventional "hardware" designs assure you of compatibility with almost any application for 
which you intend to use the SuperBrain II. 

Once you read our operator's manual and try out some of the features described herein, we are 
confident that you too will agree with our "top performance — bottom dollar" approach to 
manufacturing. The SuperBrain II offers you many more extremely flexible features at a lower 
cost than any other microcomputer we know of on the market today. The use of newly developed 
technologies, efficient manufacturing processes and consumer-oriented marketing programs 
enables us to be the first and only major manufacturer to offer such an incredible breakthrough in 
the microcomputer marketplace. 

Browse through our operator's manual and sit down in front of a SuperBrain II for a few hours. 
Then, let us know what you think about our new system. There is a customer comment card 
enclosed in this manual for your convenience. 

Thank you for selecting the SuperBrain II as your choice for a microcomputer system. We hope 
you will be selecting it many more times in the future. 
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*** IMPORTANT*** 

Do not attempt to write or save programs on your system diskette. It has been 'write 
protected' by placing a small adhesive aluminum strip over the notch on the right hand 
side of the diskette. Such attempts willresult in a 'WRITE' or 'BAD SECTOR' error. 

Before using your SuperBrain II, please copy the System Diskette onto a new blank 
diskette. If you do not have such a diskette, contact your local dealer. He should be 
able to supply you with one. If you have any questions concerning this procedure, 
please contact your dealer before proceeding. Failure to do so may result in perma- 
nent damage to your System Diskette. 

BEFORE APPLYING POWER TO THE MACHINE INSURE THAT NO DISKETTES ARE 
INSERTED INTO THE MACHINE. NEVER TURN THE MACHINE ON OR OFF WITH 
DISKETTES INSERTED IN IT. FAILURE TO OBSERVE THIS PRECAUTION WILL MOST 
DEFINITELY RESULT IN DAMAGE TO THE DISKETTES. 
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INTRODUCTION 



The Superbrain II Video Computer System represents the latest technological advances in the 
microprocessor industry. The universal adaptability of the SuperBrain CP/M* Disk Operating 
System satisfies the general purpose requirement for a low cost, high performance 
microcomputer system. 

From the standpoint of human engineering, the SuperBrain II has been designed to minimize 
operator fatigue through the use of a typewriter-oriented keyboard and a remarkably clear 
display. The SuperBrain II displays a total of 1,920 characters arranged in 24 lines with 80 
characters per line. The video display characters can be varied between a primary and 
secondary character set. Blinking, half-intensity, underlining, and reverse video are user 
selectable display options. The video display is crisp and sharp due to Intertec's own specially 
designed video driver circuitry. And, the high quality, non-glare etched CRT face plate featured on 
every SuperBrain II assures ease of viewing and uniformity of brightness throughout the entire 
screen. 

The SuperBrain M's unique internal design assures users of exceptional performance for just a 
fraction of what they would expect to pay for such "big system" capabilities. The SuperBrain II 
utilizes a single board "microprocessor" design which combines all processor, RAM, ROM, disk 
controller, and communications electronics on the same printed circuit board. This type of design 
engineering enables the SuperBrain II to deliver superior, competitive performance. 

Standard features of every SuperBrain II include: two mini-floppy disk drives with up to 1.5 
megabytes formatted disk storage, 64K of dynamic RAM memory, recognized CP/M* Disk 
Operating System featuring its own text editor, an assembler for assembly language 
programming, a program debugger and a disk formatter. Also standard are dual universal RS232 
communication ports for serial data transmission between a host computer network via modem 
or an auxiliary serial printer. A number of transmission rates up to 9600 baud are available and 
selectable under program control. 

Other standard features of the SuperBrain II include: special operator convenience keys, dual 
"restart" keys to insure simplified user operation, a full numeric keypad complement (whose 
values can be user reassigned by software), and a high quality typewriter compatible keyboard. 
Additionally, a real time clock is incorporated for time/date display and is user accessible. 

For reliability, the SuperBrain II has been designed around five (5) basic modules packaged in an 
aesthetically pleasing desk-top unit. These major components are: the Keyboard/CPU module, 
the power supply module, the CRT assembly, the transition board, and the disk drives themselves. 
Failure of any component within the terminal may be corrected by simply replacing only the 
defective module. Individual modules are fastened to the chassis in such a manner to facilitate 
easy removal and reinstallation. 

Terminal down-time can be greatly minimized by simply "swapping-out" one of the modules and 
having component level repair performed at one of Intertec's Service Centers. Spare modules 
may be purchased from an Intertec marketing office to support those customers who maintain 
their own "in-house" repair facilities. 

The SuperBrain II cover assembly is exclusively manufactured "in-house" by Intertec. A high- 
impact structural-foam material is covered with a special "felt-like" paint to enhance the overall 
appearance. Since the cover assembly is injected-molded, there is virtually no possibility of 
cracks and disfigurations in the cover itself. By manufacturing and finishing the cover assembly 
in-house, Intertec is able to specify only high quality material on the external and internal cover 
components of your SuperBrain II to insure unparalleled durability over the years to come. 

*CPM is a registered trademark of Digital Research 
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A wide variety of programming tools and options are either planned or available for the 
SuperBrain II. Software development tools available from Intertec include Basic (standard) and 
Fortran (optional) programming languages. A wide variety of applications packages (general 
ledger, accounts receivable, payroll, inventory, word processing, etc.) are available to operate 
under SuperBrain II CP/M Disk Operating System from leading software vendors in the industry. 
Disk storage capability is expandable by interfacing the SuperBrain II to a rigid disk which 
increases on-line storage to 10 megabytes or more. 

The high performance ratio of the SuperBrain II has rarely been equalled in this industry. By 
employing innovative design techniques, the SuperBrain II is not only able to offer a competitive 
price advantage but boasts many features found only in systems costing three to five times as 
much. The SuperBrain II twin Z80A microprocessors insure extremely fast program execution 
even when faced with the most difficult programming tasks. Additionally, each unit must pass a 
grueling 48 hour burn-in before it is shipped to the customer. By combining advanced 
microprocessor technology with in-house manufacturing capability and stringent quality control 
requirements, your SuperBrain II should provide unparalleled reliability in any application into 
which it is placed. 
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FEATURE 

CPU 

Microprocessors 

Word Size 

Execution Time 

Machine Instructions 

Interrupt Mode 

FLOPPY DISK 

Storage Capacity 
(Formatted) 

Data Transfer Rate 
Average Access Time 
Media 

Disk Rotation 
INTERNAL MEMORY 
Dynamic RAM 
Static RAM 



FIRMWARE 
DAY/DATE CLOCK 

CRT 

Display Size 
Display Format 
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SYSTEM SPECIFICATIONS 
DESCRIPTION 



Twin ZSOA's with 4MHZ Clock Frequency. One Z80A (the 
host processor) performs all processor and screen related 
functions. The second Z80A is "down-loaded" by the host 
to execute disk I/O. 

8 bits 

1.0 microsecond register to register 

158 

All interrupts are vectored 



SuperBrain II Jr — 328 KB 
SuperBrain II QD — 680 KB 
SuperBrain II SD — 1.5 MB 

250K bits/second 

250 milliseconds. 6 milliseconds track-to-track. 

5y4-inch mini-disk 

300 RPM 



64K bytes dynamic RAM 

2048 bytes of static RAM is provided in addition to the main 
processor RAM. IK x 8 of this RAM storage is used as a 
disk buffer. The remaining RAM is used for attribute 
storage. 

2K X 8 bytes standard. Allows "bootstrapping" of system at 
power-on. 

Provides continuous time display. Maintains time and date 
information during power-off and compensates for 
variances in month/year lengths. 



12 inch, specially focused, P4 phosphor, non-glare screen. 
24 lines x 80 characters per line 
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FEATURE 

Character Font 

Display Presentation 

Bandwidth 
Cursor 
COMMUNICATIONS 
Screen Data Transfer 
Auxiliary Interface 

Main Interface 

Transparent Mode 
Parity 

Transmission Mode 
Addressable Cursor 

SYSTEM UTILITIES 

Disk Operating System 
DOS Software 

BASIC 

OPTIONAL SOFTWARE 
Languages 



SYSTEM SPECIFICATIONS (continued) 

DESCRIPTION 

5x7 character matrix (with descenders) on a 7 x 10 
character field. All displayed characters are derived from 
character sets stored on interchangeable EPROMS. 

Light characters on a dark background. Blinking, half- 
intensity, underlining, reverse video attributes standard; 
optional on-line secondary Character/Graphic set. 

20 MHZ 

Reversed image (block cursor) 



Memory-mapped at 38 kilobaud. 

Simplified RS-232 asynchronous. Parallel interface 
available. Baud rates are software selectable from 50 to 
9600 baud. 

Universal RS-232 asynchronous. Synchronous interface 
switch selectable. Baud rates are software selectable from 
50 to 9600 baud. 

Enables display of all incoming and outgoing control codes. 

Choice of even, odd, none 

Half or Full Duplex. One, one and one-half, or two stop bits. 

Direct positioning by either discrete or absolute 
addressing. 



CP/M 2.2 

An 8080 disk assembler, debugger, text editor and file 
handling utilities. 

Sequential and random disk access. Full string 
manipulation, interpreter. 



FORTRAN; ANSI standard with relocatable, random and 
sequential disk access. Additionally, any user furnished 
CP/M compatible software package that can reside in 52K 
of memory. 
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SYSTEM SPECIFICATIONS (continued) 

DESCRIPTION 

Extensive software development tools are ayailable 
including software for the following applications: Payroll, 
Accounts Receivable, Accounts Payable, Inventory 
Control, General Ledger and Word Processing. Contact an 
Intertec Sales Office for connplete details. 



KEYBOARD 

Alphanumeric Character Set 
Special Features 
Numeric Pad 

Cursor Control 
INTERNAL CONSTRUCTION 
Cabinetry 
Component Layout 

ENVIRONMENT 
Weight 

Physical Dimensions 
Environment 

Power Requirements 



Generates all 128 upper and lower case ASCII characters. 

N-key Rollover, type ahead, and key repeat 

0-9, decimal point, comma, minus and four cursor control 
keys. Reprogrammable to other values for individual 
applications. 

Up, down, forward, backward 



Structural foam 

Five board modular design. All processor related functions, 
RAM, controllers and keyboard are on a single printed 
circuit board. All video, chaining, and power related circuits 
on separate boards. 



Approximately 45 pounds 

14-5/8" (H) X 21-3/8" (W) x 23-1/8" (D) 

Operating 0° to 50*^ Storage: O*' to 85° C; 10 to 95% 
relative humidity — non condensing. 

115 VAC, 60 HZ, 1 AMP (optional 230 VAC/50HZ model 
available) 
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INTERNAL CONSTRUCTION 



Perhaps the most remarkable feature of the SuperBrain II is its modular construction using only 
five major subassemblies which are clearly defined in their respective functions so as to facilitate 
ease of construction and repair. These five subassemblies are shown and described below. 
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KEYBOARD/CPU MODULE 

The control section of the SuperBrain II Video Computer is based upon the widely acclaimed 
Z80A microprocessor. The result is far fewer components and the ability to perform a number of 
functions not possible with any other approach. The Keyboard/CPU module contains the 
SuperBrain II twin Z80A microprocessors. One Z80A (the host processor) performs all processor 
and screen related functions while the second Z80A can be "downloaded" to execute disk I/O 
handling routines. The result is extremely fast execution time for programs. 

In addition to containing the SuperBrain ll's microprocessor circuitry, the Keyboard/CPU module 
contains 64K of dynamic RAM. Also found on this module is: the character and keyboard encoder 
circuitry, the "bootstrap" EPROM, the disk controller and all communications electronics. Power 
is supplied to this module via a single 7 pin ribbon cable connected to the SuperBrain ll's main 
power supply module. Connection of this module to the disk drive modules is via a separate 
ribbon cable. Separate connectors also exist for the CRT display signals and serial I/O ports. 












.11 



..i 



dt- r I " S?i%" Si'' -.3=; ; 



mi 



I. i 


)°, 


n 

3 


A 


% 
: 5 


6 7 


8 9 





+ 


\ 


SF 


fj.* 8«S*K 


1- 1 


oj 


W 


E 


3 


T 


Y 


u 


1 





P 


i\ 


\ 


lit* 


mvt m 


0-. |sa 


A 


s 


r- 


F 


G 


H 


J 


K 


L 




; 


3 

C 


.^r^ 


^«" z 


x 


clvl 


•1 


N 


"h 


>\ 


J 


s*srT 


•rm 



|i« 



CRT DISPLAY MODULE 

The CRT Display Module consists of a 12 inch, high resolution, cathode ray tube mounted in a 
rigid aluminum chassis. The faceplate of the CRT is etched in order to reduce glare on the surface 
of the screen and provide uniform brightness throughout the entire screen area. The CRT display 
presentation is arranged in 24 lines of 80 characters per line for a total display capacity of 1 ,920 
characters. 



The CRT video driver circuitry is mounted in the base of the CRT chassis to facilitate ease of 
removal and subsequent repair. In this manner, either the CRT itself or the video circuitry can be 
easily exchanged without disrupting any of the other major modules within the terminal. 
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This module is easily removed for service or replacement. A single edge connector is provided for 
connection to SuperBrain ll's Keyboard/CPU Module. 
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MAIN POWER SUPPLY MODULE 



The SuperBrain ll's power supply is of a "solid-state, switching" design and employs a voltage 
regulator to provide many years of trouble-free service. This design reduces heat dissipation and 
allows for efficient cooling of the entire terminal with a specially designed whisper fan to reduce 
environment noise. The entire power supply can be easily removed by unscrewing the screws 
holding it to the disk drive back plate. This module supplies the five voltages required to power the 
Keyboard/CPU module, the Video Module, and disk drive. 





TRANSITION BOARD 

This board contains the RS-232 serial I/O connectors and video brightness control. It connects to 
the video module and the keyboard/CPU module. 
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DISK DRIVE MODULES 



The SuperBrain II has a specially designed double-density disk drive subassembly. Each 
SuperBrain II contains two of these type drives which are mounted conveniently just to the right of 
the CRT display module on a rugged aluminum mounting bracket so that they are flush mounted 
with the front "bezel" of the unit. Power to these drives is derived from the Power Supply Module 
located just behind the drive assemblies themselves. Data to and from these drives is routed via a 
single 34 pin ribbon cable connecting the drives to the Keyboard/CPU module. 




Front View of SuperBrain II Drive Assembly 
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Side View of SuperBrain II Drive Assembly 
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THEORY OF OPERATION 



The SuperBrain II contains two Z80 microprocessors. uP1 is the main processor which executes 
all user programs from the 64K RAM main memory, while transparently managing the CRT 
Display processes. All user I/O is also connected to uP1. This I/O includes the Serial Ports, 
Interface Controller, Keyboard Encoder, Time/Date Clock, and the External Bus. uP2 performs all 
floppy disk control functions from instructions contained in the 2K Bootloader EPROM. Part of this 
same EPROM contains the Cold Bootloader for uP1, and is executed when a System Reset is 
performed. The Floppy Disk Control section also contains a 1 K x 8 RAM buffer used for temporary 
storage of disk read/write data. This buffer can be accessed by either uP1 or uP2, therefore, a 
protocol exists to prevent microprocessor contention for this buffer. 

The 64 kilobyte main memory consists of thirty-two 16K x 1 bit dynamic RAMS. These are divided 
in four banks (0-3) with each bank containing 16 kilobytes of storage. The RAS-CAS timing 
sequence necessary for memory access is created by the memory timing generator. 

The CRT-VIDEO CONTROLLER circuitry is divided into three main areas: The CRT controller 
which generates all the timing signals for data display; the character generator circuitry which 
produces the character font; and the attribute generation circuitry which provides the special 
video capabilities of blinking, underlining, half-intensity, and reverse video in addition to normal 
video display. 

The capability exists to install an alternate character set EPROM as an option. This would allow 
the CRT controller to access either character set during normal operation. 

The CRT controller generates all the timing necessary to display 24 rows of characters with 80 
characters per row. Thus the screen can display a total of 1,920 characters. These characters 
are stored in the CRT refresh buffer which is the upper 2,048 bytes (2K) of main memory. 

Because the CRT buffer is not a separate buffer and the processor must also use the same bus to 
access memory, this bus must be timeshared between the two. This is accomplished by the CRT 
controller performing a direct memory access (DMA) cycle which is done at the last scan line of 
each character row. Each character row is divided into ten scan lines, therefore, during the last 
scan line time, the controller takes control of the processor bus by generating a bus request. After 
acquiring the bus, it reads 80 characters from the CRT buffer and loads them into the 80 x 8 shift 
register. This data is then recirculated in the buffer for the next nine scan lines to produce one 
row of video characters. Therefore, there are twenty-four DMA cycles performed per vertical 
frame. 

There are also twenty-five interrupts generated — one for each row scan and one extra during 
vertical blanking. During the first twenty-four, the processor sets or resets the video blanking 
depending on whether that row is displayed or not. During the vertical blanking interrupt, the 
address registers in the CRT controller are initialized to the correct top-of-page address and the 
cursor register is also updated. 

The Interface Controller is basically three 8 bit I/O ports (8255). Through this device, the 
processor can obtain status bits from other devices and react to the status by setting/resetting 
individual bits in the 8255. 

The Keyboard Encoder scans the keyboard for a key depression, determines its position, and 
generates the correct ASCII code for the key. The processor is flagged by the 'Data Ready' signal 
via the Interface Controller. The character is then input by the processor. 

The Time/Date clock is accessed directly by uPl through an I/O address. The clock has a battery 
power supply and will maintain the correct time and date when the external power is removed. 
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The clock is also available as a real time clock for the user's access. 

There are also two RS232C serial interface ports. The main port is capable of synchronous or 
asynchronous operation. The aux port is a simplified port used for asynchronous operation only. 
The baud rates are variable from 50 baud to 9600 baud. The mode of operation of the main port 
and the baud rate of both ports are set up by the operating system and can be changed by using 
the "CONFIGUR" program. 

As previously mentioned, uP1 has the capability of communicating with the RAM and ROM in the 
FLOPPY DISK CONTROLLER. Because the amount of main memory used is the maximum that 
the processor addressing can support, different 16K banks of main memory must be switched off 
line when communicating with the disk RAM or EPROM. In these cases Bank (0000H-3FFFH) is 
switched out when communicating with the EPROM, and Bank 2 (8000H-BFFFH) when 
communicating with the RAM. 

The FLOPPY DISK CONTROLLER performs all disk related I/O functions upon command from the 
main processor. These commands are: 

* Restore to track 

* Read sector 

* Write sector 

* Write sector with verify 

* Format 

The parameters associated with drive, side, track, and sector numbers are loaded, a status word 
is set at a specified location in the disk RAM. When uP2 receives this status, it sets the 'disk busy' 
status bit and performs the indicated function. Upon completion, it resets the 'busy' bit thus 
allowing the main processor (uP1) to retrieve data and status from the RAM. 
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INSTALLATION AND OPERATING INSTRUCTIONS 



UNPACKING INSTRUCTIONS 

Be sure to use extreme care when unpacking your SuperBrain II Video Computer System. The 
unit should be unpacked with the arrows on the outside of the shipping container facing up. 

The MASTER SYSTEM DISKETTE is located inside the front cover of this manual. Be careful not 
to discard or misplace this diskette as it will be vital for the later operation of the equipment. If you 
ordered additional, optional software with your computer, it will be shipped under separate cover. 

Now that you have located your system diskette you can proceed to remove the terminal. If you 
should experience any difficulties, rotate the carton on its side. With the terminal in this position, 
you should now be able to pull outward on the terminal and separate it from the box. Once the 
terminal is out of the carton, place it on a table and remove the protective plastic bag which 
should be surrounding the terminal. DO NOT DISCARD THE SHIPPING CARTON SINCE IT 
COULD POSSIBLY BE USED FOR RESHIPPING AT A LATER DATE. 

SETUP 

The first step in this procedure is to verify that your SuperBrain II is wired for a line voltage that is 
available in your area. This can be ascertained by checking the serial tag located at the right rear 
of the terminal. This tag should indicate that your unit is set up for either 110 or for a 220 VAC 
operation. DO NOT ATTEMPT TO CONNECT THE SUPERBRAIN II VIDEO COMPUTER SYSTEM 
TO YOUR LOCAL POWER OUTLET UNLESS THE VOLTAGE AT YOUR OUTLET IS IDENTICAL TO 
THE ONE SPECIFIED ON THE BACK OF YOUR TERMINAL. If the voltages differ, contact your 
dealer at once and do not proceed to connect the SuperBrain II to the power outlet. 

Before connecting the SuperBrain II to the wall outlet, be sure that the power switch located at 
the left rear corner is turned OFF. You may now proceed to connect your computer system to the 
wall outlet. After completing this connection, turn the power switch to the ON position. At this 
time, you should hear a faint "whirring" sound coming from the fan in the computer. After 
approximately 60 seconds the message INSERT DISKETTE INTO DRIVE A will appear on the 
screen. If this message does not appear on the screen after approximately 60 seconds, 
simultaneously depress the two RED keys located on either side of the alphanumeric keyboard. 
These are the master system reset keys and should reinitialize the computer system, thereby 
displaying the 'INSERT' message on the screen. If, after several attempts at resetting the 
equipment you are unable to get this message to appear on the screen, turn the unit off for 
approximately 3 to 5 minutes and then reapply power to the unit. If you are still unable to get the 
appropriate message to appear on the screen, contact your Intertec representative. 

SYSTEM DISKETTE 

Now that you have power applied to the machine and the INSERT DISKETTE message has been 
displayed in the upper left hand corner, you are ready to proceed with loading the computer's 
operating system. This is accomplished by locating the small 5 74" diskette that was packed with 
this manual. Once you have located this diskette, you will notice that a small adhesive strip has 
been placed over the notch on the right hand side of the diskette. This aluminum strip is used to 
"WRITE PROTECT" the diskette. Therefore, you may only read programs from this diskette. If you 
wish to write or save programs on the system diskette, it will be necessary to remove the small 
adhesive aluminum strip from the diskette. This is NOT RECOMMENDED as it will subject your 
diskette to accidental errors that may be caused by you while you are getting familiar with the 
operating system. 

You are now ready to proceed with inserting the system diskette into the machine. When facing 
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the front of the machine, you will notice that there are two small openings on the right hand side 
of the machine. The leftmost opening is designated as drive A. The rightmost opening is 
designated as drive B. This distinction is important since the disk operating system can only be 
loaded from drive A. 

Open the disk drive door on drive A (the leftmost drive). The drive can be opened by applying a 
very slight pressure outward on the small flat door located in the center of the opening. Once the 
drive door has been opened, insert the Operating System Diskette. The front of the diskette 
should contain a small white sticker located in the upper left hand corner of the diskette. This 
diskette should contain a message indicating that it is the SuperBrain II DOS Diskette with CP/M 
Version 2.2. Be careful to insure that (1 ) the small aluminum write protect strip is oriented towards 
the top edge of the diskette and that (2) the label located in the upper left hand corner of the 
operating system diskette is facing AWAY from the screen towards the right hand side of the 
terminal. Once you have oriented the diskette in this fashion. Insert it into the terminal. 

It is EXTREMELY important that the diskette be properly oriented before inserting it into the 
machine since improper orientation will not allow the operating system to properly load. Once the 
diskette has been placed in the machine, be sure that it has been inserted all the way by applying 
a gentle pressure on the rear edge of the diskette. Once you are certain that the diskette is fully 
inserted, close the disk drive door. This can be accomplished by applying a slight pressure on the 
door, pulling it back into the direction from which it was originally opened. Once you have closed 
the door, you will notice a small "swishing" sound. This sound is normal and indicates that the 
computer is now attempting to load the operating system. Some drives are quieter than others 
and therefore this noise may not be audible. 

After closing the door the following message should appear in the upper left-corner of the screen: 

SUPERBRAIN II DOS VER X.X, FOR CP/M 2.2 
A> 

If this message does not appear on the screen, try depressing the two RED keys located on either 
side of the keyboard. This should reset the terminal and thereby attempt to reload the operating 
system. If after several seconds, the message does not appear on the screen, try depressing the 
RED keys several more times. If repeated depressions of the RED keys do not bring up the 
indicated message, then open the door on the disk drive A and remove the system diskette and 
check to see if it was properly inserted. If you are unsure as to the proper orientation of the 
diskette, please contact the representative from whom you originally purchased your equipment. 

After you have checked the orientation of the diskette, try reinserting it into drive A (do NOT insert 
the system diskette into drive B as it will not load from drive B). Once the diskette has been 
reinserted, close the door on drive A and depress the RED keys. If after several repeated 
depressions of the RED keys, the message SUPERBRAIN II DOS VER X.X, for CP/M 2.2, does not 
appear on the terminal then contact your dealer. 

REVIEWING THE SYSTEM DISKETTE 

After you have successfully loaded the System Diskette and Disk Operating System (DOS), the 
SuperBrain II is ready to accept your disk operating system commands. At this time we will 
review several of the commands in the operating system. However, it is recommended that you 
refer to the appropriate section in this manual for a detailed description of all such commands. 
(Introduction to CP/M Features and Facilities). The most used system command is the DIR 
command. This command directs the operating system to display the directory of all programs 
contained on the system diskette. You may enter this command by simply typing the letters DIR 
on the keyboard. 
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After you have typed these letters, it is necessary to depress the RETURN key. Depressing this 
key instructs the computer to process the line of data that you have just typed. After you depress 
the RETURN key the computer should respond by displaying all of the programs on the system 
diskette. These programs will appear in a form somewhat similar to the following: 

A:ED.COM 
A:DDT.COM 
A: ASM. COM 
A:LOAD.COM 
A:DUMP.COM 

To obtain a better understanding of just what this information means, let's take a look at the first 
line: 

A:ED.COM 

The first letter on this line is the letter A. This tells you that the information following this letter is 
located on drive A. The colon serves as a separator between the drive designator ("A") and the 
file NAME and file TYPE. The file NAME is, in this case, "ED" and the file TYPE is "COM." This 
line tells the operator that a program called ED (the disk operating system text editor) is located 
on the "A" drive and is a COM type of file. A more detailed treatment of this information can be 
found in the CP/M sections of this manual. 

DUPLICATING THE OPERATING DISKETTE 

Now that you have successfully loaded the Disk Operating System on Drive A, it is important to 
duplicate this diskette. This is necessary in order to preserve the original copy of the diskette and 
guard against any possible damage to the original media. To generate a copy of the operating 
system you will first need a new blank diskette. We recommend an I ntertec diskette for this 
purpose. If you do not have any blank diskettes of similar quality, please contact the 
representative from whom you purchased your equipment. The representative should be able to 
supply you with an ample quantity of these diskettes. 

Insert the blank diskette into drive B. Follow the procedures outlined in the previous paragraphs 
regarding the insertion of the operating system diskette. The only difference is that you will be 
inserting the new blank diskette into drive B. Be sure and leave the system diskette installed in 
drive A. 

Once you have installed the new blank diskette in drive B, you are ready to "FORMAT" the new 
diskette. It is necessary to format all previously unused diskettes before attempting to transfer 
data to them. This is necessary because all information is stored on diskettes in what is known as 
a SOFT SECTORED FORMAT which necessitates the writing of certain information on the disks 
before user programs or data can be stored on them. 

To format the diskette in drive B, enter the command FORMAT and depress the RETURN key. The 
operating system will respond by asking you to select one of the following: 

* J — For formatting SuperBrain II Jr diskettes 

* Q — For formatting SuperBrain II QD diskettes 

* S — For formatting SuperBrain II SD cJiskettes 

CAUTION: SuperBrain II Jr and QD diskettes cannot be formatted on SD machines and vice- 
versa. 
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Once the appropriate option is selected, the operating system will prompt the user to insert a 
blank diskette into drive B in case that has not already been done. Next, the user should depress 
the F key to begin formatting. 

When a diskette is being formatted, the read/write heads position to track and sequentially 
writes each track. The screen displays the current track numbers. The track value displayed will 
range from: 

* 0-34 for the SuperBrain II Jr 

* 0-69 for the SuperBrain II QD 

* 0-159 for the SuperBrain II SD 

After the disk has been completely formatted, the operating system will respond by asking you 
whether to "REBOOT" the operating system or whether you wish to format another disk. If you 
wish to format another disk, remove the newly formatted disk from drive B and insert a new blank 
diskette into drive B. You may now proceed to format this new diskette by once again entering the 
letter F. If you do not wish to format any more diskettes, simply enter a RETURN, 

The Operating System should now reload and once again be ready to accept new commands. 

Since the intent of this procedure was to copy the original disk operating system we are now 
ready to begin that procedure. This can be accomplished by entering the following command on 
the keyboard: 

A>PIP B: = *.*[V] <cr> 

After you have entered the above command at the keyboard, depress the RETURN key. 

The system will now begin to copy and verify all of the programs on drive A over to drive B. As 
each program is copied, its name will be displayed on the screen. This procedure takes 
approximately 5 to 10 minutes. When the procedure completes, the control of the operating 
system will be returned to the user. 

Now that you have completed copying the programs from the A drive to the B drive it is necessary 
to copy the disk operating system itself (which is located on tracks 0, 1 ) onto drive B. This may be 
accomplished by entering the following command at the keyboard: 

A>SYSGEN <cr> 

The SYSGEN command is used to read the operating system from a diskette and place it on the 
desired diskette. Once you have entered this command at the keyboard and typed RETURN, the 
disk operating system will ask you to select which drive you want to take the source from. The 
correct answer to this question is the letter "A". After entering A depress the RETURN. 

The next question the program will ask is where do you want the source to be placed (the 
destination drive). The correct answer to this is the letter "B" indicating drive B. Once you have 
entered this, the operating system will be copied from drive A onto drive B. 

After this process has been completed the operating system will ask whether you wish to make 
another copy or to reload the operating system. The correct response is to simply enter a 
RETURN which will reload the operating system. 

Once the operating system has been reloaded, you may remove the master disk operating 
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system in drive A. Once this disk has been removed, store it in a safe place, as you may need it 
later to generate additional copies of the disk operating system and its programs. 

At this point you should have removed the masterdisk from drive A. Now remove the copy from 
drive B and reinstall it in drive A and close the door on drive A. After you have completed this, 
depress the RED reset keys located on either side of the keyboard. This will reset the machine 
and reload the newly installed operating system from the new system diskette. 

IMPORTANT: If random, garbled information is displayed on the screen at this time, this indicates 
that an error was made in the use of the SYSGEN program. If this is the case, remove>the new 
diskette from drive A and reinstall the original master system diskette and repeat the previously 
outlined procedure for generating a new disk operating system. If you still encounter difficulties, 
please refer to the CP/M sections of this manual for more detailed information concerning the 
SYSGEN procedure. 

Now that you have successfully completed the generation of a new system diskette, please refer 
to the CP/M sections of this manual for a complete description of all of the operating system utility 
programs (DDT.COM, PIP.COM, SUBMIT.COM, etc.). 

OPTfONAL SOFTWARE 

MICROSOFT FORTRAN 80 — comparable to Fortran compilers on large mainframes and 
minicomputers. All of ANSI standard Fortran X3.9-1966 is included except the COMPLEX 
datatype. Therefore, users may take advantage of the many application programs already written 
in Fortran. Fortran 80 is unique in that it provides a microprocessor Fortran and assembly 
language development package that generates relocatable object modules. This means that only 
the subroutines and system routines required to run Fortran 80 programs are loaded before 
execution. Subroutines can be placed in a system library so that users develop a common set of 
subroutines that are used in their programs. Also, if only one module of a program is changed, it is 
necessary to recompile only that module. Additionally, numerous optional software packages are 
available for use with your SuperBrain II Video Computer System. If you would like additional 
information on these packages, please contact your local Intertec representative. 




6831010 2-5 




SUPERBRAIN II 
SOFTWARE SUMMARY 



SuperBrain II 

Users Manual 

SuperBrain II Software Summary 

SUPERBRAIN II SOFTWARE SUMMARY 

The software distributed with the SuperBrain II is basically of two types. First, CP/M and 
miscellaneous software from Digital Research provide an operating system, and various utility 
programs. Second, there are utility programs prepared by Intertec for special features or 
functions of the SuperBrain II and an interpreted BASIC from Microsoft. A summary of both 
categories follows: 



CP/M SUMMARY 

PROGRAM 
NAME 



FUNCTION 



ENTRY 
EXAMPLE 



PIP.COM Copies files between devices, logical and physical. PIP B: = A:*.*<cr> 

PIP CON: = A:FiLE.TYP<cr> 

SYSGEN.COM Generates a new operating system on diskette. SYSGEN<cr> 

ED.COM Text Editor, allows changes to text files. ED PROGRAM.ASM<cr> 

ASM.COM Assembles an 8080-type assembly language that ASM PROG<cr> 

produces a source listing and a 'HEX' file. 

L0AD.COM Creates a binary object file from a 'HEX' file that LOAD PROG<cr> 
can be executed. 

DDT.COM Allows user to debug and step through a 'COM' or DDT PROG.COM<cr> 

'HEX' file's execution. DDT PROG.HEX<cr> 



SUBMIT.COM Performs successive execution of a list of 
'COM' files. 



SUBMIT MORNING <cr> 



XSUB.COM 

DUMP.COM 

STAT.COM 

DIR* 

ERA* 
REN* 
SAVE* 
TYPE* 



Forces data entry into a process under control of XSUB<cr> 
SUBMIT. 



Produces a hexadecimal listing of a disk file's 
contents. 

Display file status, device status, or system 
characteristics. 

Displays a disk directory. 

Erases a disk file. 

Renames a disk file. 

Saves memory contents on the disk. 



DUMP PR0G.COM <cr> 

STATB:*.*<cr> 
STAT B:DSK: <cr> 

DIR<cr> 
DIR B:<cr> 

ERA B:PROG.BAK<cr> 

REN PROG.ASM = PROG<cr> 

SAVE10 A.COM<cr> 



Displays an ASCII listing of a disk file's contents. TYPE PROG.PRN<cr> 



•These are CP/M command level functions. 
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These programs or commands run under the CP/M 2.2 disk operating system (DOS). This DOS Is 
customized for each SuperBrain II computer model available, which results in having three 
operating systems applicable to the SuperBrain II product line. These are: 

* SBIICPM.COM — SuperBrain II Jr computer. The corresponding BIOS is 

SBIIBIOS.ASM. 

* QDIICPM.COM — SuperBrain II QD computer. The corresponding BIOS is 

QDIIBIOS.ASM. 

* SDIICPM.COM — SuperBrain II SD computer. The corresponding BIOS is 

SDIIBIOS.ASM. 

The difference between these models of the SuperBrain II computer is the amount of on-board 
floppy disk storage each contains. The correct operating system is distributed with each 
computer. 

Refer to later sections of this manual for detailed documentation of CP/M usage and capabilities. 

INTERTEC UTILITY SUMMARY 

Program Name Function 

C0NFIGUR.COM Establishes certain user selectable operating characteristics of the 
SuperBrain II. 

F0RMAT.COM Prepares previously unused diskettes for use in the SuperBrain II disk 

drives by placing sector information on them. 

HEXDUMP.COM Generates an "Intel" hexadecimal format data stream from any binary 
object file in the SuperBrain II computer and outputs it to a port. 

64KTEST.COM Performs extensive memory testing for diagnostic purposes. 

RX/TX.COM A program pair that enables file transfers between two SuperBrain II 

computers. 

CSEDIT.COM A program that allows the user to generate or modify an alternate character 

set. 

CSDUMP.COM A program that allows the user to generate printed output of the alternate 

character set built with CSEDIT for documentation purposes. 

TIME.COM A program that allows the time maintained by the real time clock to be set 

and/or displayed. 

DATE.COM A program that allows the date to be entered or displayed. 

MBASIC.COM An interpreted type BASIC. 

In general, the Intertec utility programs are self-documenting and designed for ease of use. To 
support this design further, documentation of these programs follows. The interpreted BASIC 
from Microsoft is documented in a separate manual available from Intertec. 

C0NFIGUR.COM 

This program enables the user to select various operating parameters for the SuperBrain II. This 
feature allows flexibility in your computer's use. The parameters affect the MAIN and AUXILIARY 
ports, the AC line frequency, keypad assignments, audio and visual feedback, and disk 
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verification. By allowing the user to change these parameters, a variety of peripheral devices can 
be used with your SuperBrain II. 

The CONFIGUR program is menu-driven; the user selects the parameter to change, and then 
follows the instructions listed. To initiate the CONFIGUR command, type CONFIGUR<cr> at the 
keyboard. CONFIGUR will then accept your commands for parameter changes. After you are 
finished, press the RETURN key (you may change several of the parameters if you wish); the 
screen will clear, and you will be instructed to press both RED keys on the keyboard. This action 
will force an operating system to reload containing your new parameters, and these parameters 
will be reloaded each time you reset the operating system. 

Note that the CONFIGUR program will change the copy of the operating system located on the 
diskette in drive A. Even if your copy of C0NFIGUR.COM is located on drive B, drive A will be 
affected. A summary of parameter selections is included for reference. 

Vertical Scan Frequency 

The vertical scan frequency is selectable for 50 or 60 Hertz. This compensates for the local AC 
line frequency to prevent the display from flickering. 

Disk Write Verification 

You may select to have the Operating System perform disk read-back verification after each 
floppy disk write. This feature will 'double-check' the write operation. 

Time Display Enable/Disable 

If you wish for the time of day to be constantly displayed in the upper right corner of the screen 
upon power-up, you may select this feature here. Note that the time is always maintained 
internally, even if you choose not to display it. Also note that this setting is only for power-up, and 
you may select/deselect the time during operation by typing a Control-T (14H). 

Key Click Enable/Disable 

You may choose to have the audible feedback feature enabled upon system power-up. Whenever 
the audible feedback is enabled, the computer will inform the operator with a slight 'click' at each 
key depression. Note that this setting is only for system power-up, and the key click feature can 
be changed during operation by typing a Control-B (02H). 

Main and Aux Port Operation 

Choosing these selections will permit you to change the operating parameters of the MAIN and 
AUX serial I/O ports located on the rear of your computer. The details of this selection are 
covered below including which ports are applicable for a given feature. 

Operating Mode (MAIN Port Only) 

The MAIN port operating mode selections are synchronous and asynchronous. Be certain that 
the peripheral with which you are communicating is capable of operating in the same mode; they 
cannot be different. Note also that when changing to synchronous mode, you may need to 
change the number of SYNC Characters and the SYNC Character value. When changing to the 
asynchronous mode, you may need to change the number of stop bits. Using the synchronous 
mode requires different switch settings to be modified on the Keyboard/CPU module. Refer to the 
Synchronous Communication topic in this section for further information. 

Baud Rate (MAIN and AUX Ports) 

A wide range of baud rates can be selected for the port including rates from 9600 baud 
(approximately 960 characters/second) to 50 baud (5 characters/second). Select the baud rate 
needed to communicate with your peripheral. 
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Number of SYNC Characters (Main Port Only) 

This selection will affect the number of SYNC Characters sent to the USART upon system power- 
up. Select either one or two. 

Number of Stop Bits (MAIN and AUX Ports) 

This selection will choose the number of stop bits sent after each character when the port is 
operating in asynchronous mode. Select either 1, 1.5, or 2 stop bits. 

Character Length (MAIN and AUX Ports) 

You may select the length of the character to be transmitted and received. Many selections are 
provided to insure compatibility with older TTY and Baudot machines. Usually, eight bits is the 
standard character length. You may, however, select 5, 6, 7, or 8 bit character lengths. 

Parity (MAIN and AUX Ports) 

You may choose to check parity with each transmission. This will provide a limited 'checksum' to 
help insure that proper tran'smission has occurred. However, if parity is enabled, the application 
program will have to test the USART status register for parity error. You may also select Even or 
Odd parity. If you choose to check parity, be certain that the device with which you are 
communicating matches your setting. 

Handshaking (MAIN and AUX Ports) 

If you wish to check Data Set Ready prior to each character transmission, you should enable this 
function. This will permit a peripheral device to signal the computer whenever it cannot receive 
anymore characters. 

SYNC Character Value (MAIN Port Only) 

The SYNC Character is the byte that is sent to the USART after it has been programmed for 
synchronous communication. Generally, the ASCII value of 13H (SYN) is used, but any binary 
value may be substituted. Make certain that the SYNC Character value matches that of the 
peripheral device with which you are communicating. Enter the hexadecimal number desired. 

KEYPAD REPROGRAMMING 

The 18 key numeric keypad on the right side of the keyboard can be reprogrammed to any input 
values desired. You may, for example, wish to invert the numeric keys on the pad. They will then 
correspond to 'telephone style' with 1-2-3 on the top row and 7-8-9 on the bottom. You may wish 
to replace the keys with control-codes which are accepted by a word processing or text editing 
program. The key cap values could then be changed to descriptive messages which are easier to 
learn and understand. Any value from OOH to FFH can now be assigned to the numeric keys with 
CONFIGUR. 

When this selection is entered, an image of the keypad appears on the screen. To change the 
value of any key, depress the TAB key until the cursor is over the key you wish to change. Then 
press the escape ESC key to indicate the change needed. The cursor will position itself on the last 
line, and a blinking asterisk will replace the cursor on the key being changed. Enter the new 
hexadecimal value for this key. Your input must be a valid hex number between 0-F as invalid 
numbers will not be accepted. Press the RETURN key when you are finished. 

To restore the keypad to its original values press the R key instead of the ESC or TAB keys. The 
screen will be updated instantly, and the cursor will be repositioned at the beginning of the 
display. When all changes have been entered, pressing the RETURN key (instead of the ESC or 
TAB keys) will return you to the main menu of selections. 
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FORMAT.COM 

Before diskettes can be used by an Intertec computer, they must first be formatted. This process 
will erase the diskette of all data and write certain sector-header information on the diskette so 
that the operating system is able to properly locate data on the diskette. FORMAT.COM is a 
versatile program that will allow the user to format diskettes for the SuperBrain II. 

To load the format program from diskette, type FORMAT <cr> at the keyboard. After loading, you 
should select the type of diskette you wish to format. Once your selection has been entered, you 
will be asked to place an unformatted diskette into drive B and type the F key to begin formatting. 
When the formatting is completed, you may continue formatting by placing another diskette into 
drive B and pressing the F key. You may repeat this process until all of your diskettes have been 
formatted. Press the RETURN key to end the formatting session. 

The diskette that you format does not have to be a blank diskette. You may format an old diskette 
if you wish, but you should remember that FORMAT will destroy all data on a diskette. However, if 
the data on a diskette becomes damaged (or if you suspect that the data is damaged), copy the 
diskette onto another diskette and reformat the original. This way, you save some (or all) of the 
original data and you don't lose any diskettes. 

HEXDUMP.COM 

This is a utility designed to convert a COM file to the Intel Hex format and transmit it from the Aux 
or MAIN port to a desired port. Since the PIP program cannot transfer COM files, this utility is 
useful in effecting file transfers without the PIP program. To initiate the HEXDUMP facility, type 
the following at the keyboard: HEXDUMP<(cr>. The program will be loaded and then await your 
instructions. 

The first thing that the HEXDUMP procedure requests is the port to which you wish to dump the 
file. Here enter 1 for the MAIN port (corresponding to CP/M's PUN: and RDR: device), or 2 for the 
AUXILIARY port (corresponding to CP/M's LST: device). You must enter either a 1 or 2; invalid 
entries will be ignored. Next you may choose whether or not you wish to have the HEX file echoed 
to the console (this will display the file as transmitted). Enter 1 if you do not wish to have the file 
echoed on the screen, or 2 if you wish to have the contents echoed. Again, invalid entries will be 
ignored. 

Now you are ready to enter the file name. You must enter the drive designator, the file name and 
the file type. Separate the drive indicator from the file name with a colon (':'), and separate the 
type from the name with a period (.). Press the RETURN key after entering the name. 

Example: 

A>HEXDUMP<cr> 

HEXDUMP FILE UTILITY VER. 3.1 
SELECT ONE OF THE FOLLOWING: (TYPE THE NUMBER) 

1 —THE MAIN PORT (PUN:) 

2 — THE AUX PORT (LST:) 
2 

SELECT ECHO ON THE CONSOLE: 

1 — DO NOT ECHO ON THE CONSOLE 

2 — ECHO TO THE CONSOLE 
1 

ENTER DISC, FILE-NAME, AND FILE-TYPE TO BE TRANSFERRED. 
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A:STAT.COM<cr> 

FILE TRANSFER COMPLETED. 

In the example above, the file STAT.COM was transferred from disk A through ,the auxiliary port. 

HEXDUMP.COM will only transfer files which exist on drives A and B. If you enter an erroneous 
file-name or disk drive, the program will display an error message. If HEXDUMP.COM is unable to 
locate the given file, another error message will be given. When the transmission has completed, 
the screen will indicate this and return to the operating system. 

64KTEST.COM 

This program performs an extensive test on main memory by writing and reading all possible 
binary patterns to all locations in the random access memory (RAM). The process takes between 
eight and ten minutes to complete. 

The test procedure begins by typing 64KTEST<cr> at the keyboard. After the program is loaded 
into memory, you will be asked to remove all diskettes from their drives. If you have a Hard Disk 
Storage System connected to the terminal to be tested, either power down the hard disk or 
disconnect it from the terminal by removing the interconnecting cable. Be sure the Key Click 
feature is turned off before running the 64KTEST program. Otherwise, errors will be indicated that 
do not exist. 

Once you have pressed the G key to start the test, the screen should fill with random text. The 
patterns on the screen should move around. This is because the memory for the screen is also 
undergoing the test. After the test is completed, the screen will display RAM OK, indicating that 
the test was successful. The test is an endless loop, and will repeat until the RED keys are 
depressed simultaneously. Therefore, you can test the RAM as long as you desire. 

If an error is detected by the test, the test will stop and the audible tone will sound continuously. 
Should this occur, retry the test. If the error occurs frequently, please contact Intertec Customer 
Services Department. 

TX.COM 

The TX utility is written in standard CP/M assembly language. TX is designed to communicate via 
the computer's Main Port with the program RX running in the destination machine. Therefore, TX 
is considered the "Master" program, and RX is the "Slave" program. RX receives commands 
from TX such as "Open file", "Read incoming data block", "Write block to file", and so on. For 
this reason, the user should only be concerned with console operations for the machine in which 
TX is running. RX receives all directions from the communications link. 

Unlike data transfer operations initiated with PIP, the TX/RX pair perform block verification, and 
retransmission in the event of error. TX/RX may be used to send any type of CP/M file without 
modification including .COM files. 

TX is initiated by typing the command/ TX<cr>. The TX program will then "sign-on" with an 
identifying message and version number and then give the user an option to proceed or abort. 
The actual console dialogue appears as: 

A > TX<cr> 

INTERTEC File Transfer Utility Vers 1 .X 

HIT OR WHEN RECEIVE MACHINE READY OR Q TO ABORT 
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At this point, start up RX in the destination machine (See the RX.COM description that follows this 
TX description). 

When a carriage return is entered to TX, it will attempt to establish a linkage to the destination RX 
machine over the computer's Main Port. Given that a link can be established, TX will display the 
message: 

LINK TO SLAVE MACHINE ESTABLISHED 

or, if many attempts to link fail: 

UNABLE TO ESTABLISH/MAINTAIN DATA LINK 

(This probably indicates that some aspect of the connection with the destination machine is not 
correct, i.e. inconsistent baud rates, improper cabling, or excessive line noise.) 

The TX program then prompts the user to enter both the source file name and the destination file 
name. These names must be fully qualified, non-ambiguous file references. This includes disk 
specifiers. 

If the specified file already exists on the receiving machine, TX will display: 

FILE ALREADY EXISTS ON RECEIVING MACHINE 

and the link is terminated. 

As an expediency, send the file again, but with a temporary destination file name. 

As a file is being transmitted under TX/RX, both TX and RX will display a record count. This serves 
to indicate that the data is being transferred correctly. It is normal to see a difference of one 
record between the two counts upon completion of a file transfer. 

If TX detects a failure in the data link, it will output the message: 

UNABLE TO ESTABLISH/MAINTAIN DATA LINK 
When a file has been transmitted, TX displays the message: 

FUNCTION COMPLETE 

TYPE R TO REPEAT, OR TO EXIT 

If another file is to be transferred, enter the letter R and TX will request another pair of file names. 
Entry of a carriage return will cause TX to command RX to shutdown and both will terminate. 

There are two other messages that could be output by TX. 

As each data block is sent, a checksum is calculated and transmitted. If RX detects a 
discrepancy between the received checksum and that which has been calculated for the 
received data, it will request that TX re-send the block in question. If the block cannot be received 
correctly after several re-transmissions, the message: 

HARD DATA TRANSMISSION ERROR 

will be rendered. The most likely cause of this failure is hardware error. 

If the diskette on which RX attempts to place the incoming data file is write protected, or if there is 
not enough space to contain the incoming file, TX will display: 

RECEIVE CANNOT CLOSE FILE 
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RX.COM 

RX is an assembly language program designed to receive data files transmitted by TX from the 
computer's Main Port. It operates as a slave to the TX program, receiving commands from TX to 
perform operations on the destination machine. 

RX is initiated by typing the command RX<cr>. Upon initiation, RX displays a "sign-on" message 
of the form: 

INTERTEC File Transfer Utility Vers 1 .X 

From this point on, unless an error condition occurs, no further operator action is required. 

As each data block is received, RX outputs a running count of the data blocks received. At the end 
of each received file, RX displays the message: 

END-OF-FILE RECEIVED 
When all files have been received, TX will command RX to terminate and RX will display: 

LINK TERMINATED 

If the data link cannot be established or maintained (indicated by a message on the TX system), it 
will be necessary to reset the destination system. This is accomplished on the destination 
computer by depressing both RED keys simultaneously. 

TIME 

The TIME program is used to set or display the time data kept by the real time clock. To set the 
time, enter: 

A > TIME hh:mm (AM)(PM)<cr> 

To enter "military" time (0000 thru 2400), it is not necessary to enter AM or PM. Once the entry is 
made, the TIME program will request that any key be depressed to set the time. This allows the 
user an opportunity to synchronize the time with another timepiece. To display the time, enter: 

A>TIME<cr> 

DATE 

The DATE program is used to set or display the date maintained by the real time clock. To set the 
date, enter: 

A > DATE 04/07/82 WED<cr> 

or 

A > DATE 04/07/82 WEDNESDAY <cr> 

To display the date, enter: 
A>DATE<cr> 
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SECONDARY CHARACTER SET OPTION 



As was stated in the theory of operation section, the SuperBrain II provides a means by which a 
secondary character set option may be added. This gives the user the ability, via the software, to 
select either set. Intertec will provide a limited number of these alternate character sets, or if 
required, the customer may create a character set using software that is supplied by Intertec. In 
the following sections, both of these methods will be explained. 

INTERTEC FURNISHED SECONDARY CHARACTER SETS 

The easiest and quickest way to have access to a secondary character set would be to purchase 
one of the sets available from Intertec. This character set would be contained on an EPROM that 
would be inserted into a vacant IC socket on the processor board. After the EPROM has been 
inserted into its socket, it can be initialized via the escape sequence given in the attribute 
program section. Secondary character set installation procedures will be provided with each set 
purchased from Intertec. 

CUSTOMER CREATED SECONDARY CHARACTER SETS 

For those requirements where Intertec does not offer a suitable secondary character set, one 
can be created by the user. The CP/M disk provided with the SuperBrain II contains two utility 
programs that provide the means for creating and verifying secondary character sets. These two 
programs are CSEDIT.COM and CSDUMP.COM. 

CSEDIT.COM 

The CSEDIT utility provides the means for creating a secondary character set. The program is 
loaded from the disk by typing CSEDIT and then pressing RETURN. The initial screen message 
will read: 

SuperBrain II Character Set Editor — Ver 1.X 

Enter the character sdt file name: 




The new character set file name should then be entered in the normal format of filename.typ and 
then pressing RETURN. The next screen message will read: 

Enter hex value of character to edit (0-7F, eXit, Quit, or ?) 

As indicated by the parenthesis, there are four options (0-7F, eXit, Quit, or ?) available at this 
point. Since the "?" is the help page and will explain the other 3 entries, type ? and press 
RETURN. The following page will appear on the screen: 

The input required at this point is the hex value of the ASCII character that you wish to edit. This 
value must be in the range of 00 to 7F hex. You may also enter a "X" to exit the program and 
update the character set file, or a "Q" to abort the program and not update the character set file. 

"0" — Clear dot at current position 

"." — Put dot at current position 

ENT — Go to start of next line 

"-" — Clear current line 

"1" — Invert pattern dots 

"2" — Save pattern in temp, buffer 

"3" — Recall previously saved pattern 

"7" — Clear character cell 

ESC — End editing of character 

BRK — Abort with no change to character 
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SECONDARY CHARACTER SET OPTION (continued) 

All cursor keys on the keypad work as would be expected. 

Hit RETURN to continue: 

After reading the help page, pressing RETURN will cause the initial screen message of the 
program to reappear. At this time the user should be ready to start the process to create an 
alternate character set. The following examples are from the standard character set provided 
with the SuperBrain II. 

Editing Number- 41H 
12 3 4 5 6 




"V _ 

"3" — 
ESC — 



Put dot at current position 

Clear current line 

Invert pattern dots 

Recall previously saved pattern 

End editing of character 



"0" — Clear dot at current position 

ENT — Go to start of next line 

"2" — Save pattern in temp, buffer 

"7" — Clear character cell 

BRK — Abort with no change to pattern 



Editing Number - 65H 
1 2 3 4 5 6 



0: 
1: 
2: 
3: 
4: 
5: 
6: 
7: 
8: 



* * * 



* * • • * 



•k -k -k 



" 1 " — _ 

"3" — 
ESC — 



Put dot at current position 

Clear current line 

Invert pattern dots 

Recall previously saved pattern 

End editing of character 



"0" — Clear dot at current position 

ENT — Go to start of next line 

"2" — Save pattern in temp, buffer 

"7" — Clear character cell 

BRK — Abort with no change to pattern 
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SECONDARY CHARACTER SET OPTION (continued) 

Editing Number -OBH 
1 2 3 4 5 6 




"1" _ 

"3" — 
ESC — 



Put dot at current position 

Clear current line 

Invert pattern dots 

Recall previously saved pattern 

End editing of character 



"0" — Clear dot at current position 

ENT — Go to start of next line 

"2" — Save pattern in temp, buffer 

"7" — Clear character cell 

BRK — Abort with no change to pattern 



After all the secondary characters have been created, by typing "X" and pressing RETURN, the 
new character set will be written on the disk as a binary file and the verification process can 
begin. 

CSDUMP.COM 

The CSDUMP utility will be used to verify that the character set that was just created is what is 
needed. To run the CSDUMP program, insure the SuperBrain II is connected to a printer via the 
Auxiliary port. The printer is the only output device that will display the dump. Once this is 
accomplished, type CSDUMP, and press the RETURN key. The following message will appear on 
the screen. 

SuperBrain II Character Set Dump - Ver 1 .X 

Enter character set file name : 

Enter the file name and press the RETURN key. The character set will be dumped out to the 
printer and the resulting page set should look similar to the one shown on the Sample Page — 
Character Set Dump exhibit. 

The character file generated by this procedure can then be transferred to an EPROM 
programming machine using the HEXDUMP.COM utility. Once the EPROM has been created, it 
should then be inserted into the empty 10 socket Z75, as indicated in the Socket Z75 exhibit. The 
initialization of the new character set is contained in the Escape Sequence covered in the 
Attribute section of this manual. 

The part numbers for the blank EPROM are, Intertec part number 301 2251 6 or Texas Instruments 
part number TMS-2516JL-35 or equivalent. 

Any questions concerning Intertec created secondary character sets or the procedures or 
materials necessary to create secondary character sets should be referred to the Customer 
Services Department at Intertec Data Systems Corporate Headquarters. 



6831010 



3-11 



SAMPLE PAGE - CHARACTER SET DUMP EXHIBIT 

Tile Narre : AtSTISET 










AS 



12 3 4 f f 
Gil velue - 40h 



2 1 2 3 -4 J e 
A?CII value - 41h 



1 2 3 4 £ f 
iSCII value - 42h 



12 3 4 5 6 
ASCII value - 43h 



A 



V V *i' 



12 3 4 5 6 
sen value - 4 4h 



12 3 4 
ASCII value 



5 e 
- ^5h 



0: 








1: 


51' 


i\t 


ilc 5;^ >;c 


2: 








"2. • 


5l^ 






4 : 


%<; 


^\^ 


5!.' JJC 


d: 


♦ 






6: 


?^' 






7: 


♦ 






p . 








r^ • 











1 


2 


3 4 5 e 


ASCII 


ve 


Amb - 4eh 


















1 






:'c 


yc 


5*J 


'I* 


2. 














'< 




't^ 










4 








Jlc 


5:>' 


5«; 


c: , 




>;^ 








5): 






'\^ 








5».^ 


9 






5'' 






*^!^ 


e- 














c 

















1 


•? 




4 


f e 


i 


.sen 


V< 


slue 


- 47h 
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ALTERNATE CHARACTER STANDARD CHARACTER 
SET EPROM SOCKET^ SET EPRCM_ 
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MISCELLANEOUS OPERATIONAL INFORMATION 



USING THE 'MNP:" AND "OUT:" FEATURES OF PIP 

Files can be transferred using the PIP program as described in the SuperBrain II manual section 
entitled 'An Introduction to CP/M Features and Facilities.' The SuperBrain II is equipped with two 
RS232C Serial interface ports (labeled 'MAIN' and 'AUX' on the rear panel). Whenever the 
SuperBrain II transmits serial data via the 'MAIN' port, the destination is designated as a punch 
(PUN:); when receiving, the data source device is considered a reader (RDR:). When transmitting 
data to the 'AUX' port, the destination device is considered a list (LST:). 

The 'MAIN' serial port may also be considered as an input (INP:) or output (OUT:) device. When 
used in this mode, the operator has the option of communicating with the sending or receiving 
device prior to file transfer by means of the SuperBrain II console. This interface is factory 
programmed for the following operational mode: 

Asynchronous Communication 

1 200 Baud Rate 

8 Bit Character Length 

1 Stop Bit 

No Parity 

DSR Disabled 

Files transferred via the 'MAIN' port must be in Intel 'HEX' or ASCII format. BASIC source 
programs must be saved in ASCII format before they can be transferred. Binary files (i.e., 
programs) must be transferred as HEX files, using the program HEXDUMP.COM. 

PLEASE NOTE THE FOLLOWING: 

1) Connect the SuperBrain II 'MAIN' port to the console input of the host computer. Make 
certain that the host computer and the SuperBrain are sending and receiving data in a 
compatible fashion (i.e., baud rate, character length, et.al.). 

2) The largest file that can be transferred by PIP is 25K. If files are larger than 25K, they 
must be broken down into smaller segments of 25K or less. 

3) Binary files (or .COM files) cannot be transferred via the serial ports using PIP. The DOS 
Diskette supplied with your SuperBrain II includes two facilities for binary file transfer. 
See TX/RX and HEXDUMP for more information. 

4) The Clear-to-Send (CTS - Pin 5) line on the 'MAIN' port must be high (logical '1 ') before the 
SuperBrain II will send data through this port. Insure that these signals are properly 
connected between SuperBrain II and the host computer. 

5) The 'MAIN' port is arranged so that the SuperBrain II appears as a processor rather than 
a terminal. If it is to be used as a terminal, pins 2 and 3 in the RS-232-C cable must be 
interchanged. 

The following represents a sample file transfer session. Please note that bold characters are 
those typed by the operator, and the symbol '(or)' means the 'RETURN' key. 

A. Transfer an ASCII file from SuperBrain II to host computer: 

(File name is ABC.FIL) 

A>PIP OUT: = ABC.FIL<cr> 

ECHO (Y/N) Y 
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NOTE — The SuperBrain II will now perform as a terminal for the host computer. If you wish, you 
may transmit a line of text to the host computer before the file ABC.FIL is actually transferred. 
Anything typed at the console will be sent to the host computer. To initiate the file transfer, type 
Control-B. 

Control-B (Hold down the CTRL Key, then 'B') 

The file will be transferred, and should be displayed on the screen. Upon completion, PIP will exit 
and return to the operating system. When finished, it is riecessary to signal end-of-file for the host 
computer. This is best done by using the EOF: facility of PIP: 

A>PIPOUT: = EOF:<cr> 

ECHO(Y/N)Y 

+ 

CTRL B (Hold down the CTRL key, then 'B') 

NOTE — The EOF presumes that the target machine uses a hex 1 A (CTRL-Z) to indicate end of 
file. 

The file transfer is now complete. 

B. Transfer an ASCII file to the SuperBrain II from the host computer: 
(File name is ABC.FIL) 

A> PIP ABC.PRN = INP:<cr> 

ECHO(Y/N) Y 

The SuperBrain 1 1 is now ready to receive input from the host computer. Any further console entry 
at the SuperBrain II will be sent to the host computer. If the'host computer does not send an end- 
of-file character, it will be necessary for you to place one into the file. This is done with the 
following command: 

Control Z (Hold down the CTRL key, then 'Z') 

End of File, Control Z? (The computer asks for confirmation) 

Control Z (Hold down the CTRL key, then "'Z') 

C. Transfer a Binary (or COM) file. 

PIP does not permit binary files to be transferred via the serial port. Two system utilities, 
HEXDUMP and TX/RX, are provided to facilitate this. HEXDUMP will convert a binary file into a 
HEX format, and transmit out the 'MAIN' port. If HEXDUMP is used, the receiving unit must use 
PIP to accept the input from the sending unit. After the file transfer, the file can be converted back 
into a binary file using the DDT system program or the LOAD system program. 



SYNCHRONOUS COMMUNICATION 

Your computer system is factory configured to program the Universal 
Synchronous/Asynchronous Receiver/Transmitter (USART) to operate in the asynchronous 
mode. It is possible, however, to change this and permit the synchronous communication mode. 
You will be responsible for writing the software drivers that send and receive synchronous data 
through to the MAIN port at the rear of your terminal. This section will 
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instruct you to properly program the USART which is the interface between the CPU and the main 
port of your computer. 

Before proceeding, it would be helpful to read the specifications sheets for the 8251 -type USART. 
On these sheets you are given the control words to reprogram the USART to enable synchronous 
communication. It is important that the timing dipswitch, located on the processor board, be 
properly set. This is necessary to coordinate the clock pulses between the two terminals 
communicating in the synchronous mode. 

The SuperBrain II computer system stores the command byte for the 8251 USART in memory. To 
use a different type of communication, several steps are necessary. The USART command word 
must be changed in order to change the USART's operating mode. The operating system must 
also be prevented from resetting the USART during an interrupt cycle. 

SuperBrain II Serial Communications DIPSWITCH 

The serial communication DIP switch is located on the Keyboard/CPU printed circuit board inside 
the cabinet. It is accessed by removing the four screws from the bottom of the base that holds the 
cover in place. Next, make sure that the disk drive doors are closed, then lift off the cover. This 
will expose the Keyboard/CPU Module. The Dip switch is a five position switch on the top edge of 
the Keyboard/CPU Module. It is the only user settable switch on this module. 

NOTE: When completing the procedures above, you may encounter a warranty certification seal. 
The seal will be positioned over one of the four bottom cover screws and clearly displays the 
warning, WARRANTY IS VOID IF LABEL REMOVED. This seal should not be removed if you intend 
to participate in any of Intertec's Satisfaction Assurance programs. Once this seal has been 
removed, the unit no longer qualifies for participation within these programs. For additional 
information concerning Intertec's Satisfaction Assurance programs, contact Intertec's Customer 
Services Department. 

For the normal mode (^asynchronous communication mode), these switches should be set as 
follows: 

1 — OFF, 2 — OFF, 3 — ON, 4 — ON, 5 — OFF 

For the synchronous communication mode with another unit providing the transmitter and 
receiver clock, the switches should be set as follows: 

1 — ON. 2 — ON, 3 — OFF, 4 — OFF, 5 — OFF 

Listed below is a brief description of the function of each of these switches: 

1 — External Clock to transmitter section of MAIN USART — originates from PIN #1 5 on 
MAIN RS232 connector at rear of terminal. 

2 — External Clock to receiver section of MAIN USART — originates from PIN #17 on 
MAIN RS232 connector at rear of terminal. 

3 — Internal TX Clock to MAIN USART — When on, this switch enables the built-in baud 
rate generator (Western Digital BR-1941). 

NOTE: When this switch is in the 'ON' position, switch 1 MUST be in the 'OFF' 
position. 

*THE SWITCHES WERE SET FOR THE ASYNCHRONOUS COMMUNICATION MODE BEFORE SHIPPING FROM THE FACTORY. 
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4 — Internal RX Clock to MAIN USART — When this switch is in the 'ON' position, switch 
2 MUST be in the 'OFF' position. 

5 — Internal Baud Clock to MAIN Port — This switch enables the transmission of the 
internal baud rate clock (Western Digital BR-1 941) to the main RS232 port — this 
signal will also appear on PIN #24 of the main port when this switch is in the 'ON' 
position. If this switch is not used; it should be left in the 'OFF' position to avoid any 
possible conflict with external RS232 signals. 
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■ Synchronous and Asynchronous 
Operation 

■ Synchronous 5-8 Bit Characters; 
Internal or External Character Synchro- 
nization; Automatic Sync Insertion 

■ Asynchronous 5-8 Bit Characters; 
Clock Rate— 1, 16 or 64 Times Baud 
Rate; Break Character Generation; 1, 
1 V2, or 2 Stop Bits; False Start Bit 
Detection; Automatic Break Detect 
and Handling 

■ Synchronous Baud Rate — DC to 64K 
Baud 



■ Asynchronous Baud Rate — DC tc 
19.2K Baud 

■ Full Duplex, Double Buffered, Trans- 
mitter and Receiver 

■ Error Detection — Parity, Overrun and 
Framing 

■ Fully Compatible with 8080/8085 CPU 

■ 28-Pin DIP Package 

■ All Inputs and Outputs are TTL 
Compatible 

■ Single -f 5V Supply 

■ Single TTL Clock 



Section 
4 



The Intel® 8251A is the enhanced version of the industry standard, Intel® 8251 Universal Synchronous/Asynchronous 
Receiver/Transmitter (USART), designed for data communications with Intel's new high performance family of 
microprocessors such as the 8085. The 8251 A is used as a peripheral device and is programmed by the CPU to operate 
using virtually any serial data transmission technique presently In use (Including IBf^ "bi-sync"). The USART accepts 
data characters from the CPU in parallel format and then converts them Into a continuous serial data stream for 
transmission. Simultaneously, It can receive serial data streams and convert them into parallel data characters for the 
CPU. The USART will signal the CPU whenever It can accept a new character for transmission or whenever it has 
received a character for the CPU. The CPU can read the complete status of the USART at any time. These include data 
transmission errors and control signals such as SYNDET, TxEMPTY. The chip is constructed using N-channel silicon 
gate technology. 



DATA 

BUS 

BUFFER 





Figure 1. Block Diagram 



Figure 2. Pin Configuration 
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FEATURES AND ENHANCEMENTS 

8251 A is an advanced design of the industry stan- 
dard USART, the Intel® 8251. The 8251A oper- 
ates with an extended range of Intel micropro- 
cessors that includes the new 8085 CPU and main- 
tains compatibility with the 8251. Familiarization 
time is minimal because of compatibility and 
involves only knowing the additional features and 
enhancements, and reviewing the AC and DC speci- 
fications of the 8251 A. 

The 8251 A incorporates all the key features of 
the 8251 and has the following additional features 
and enhancements: 

• 8251 A has double-buffered data paths with 
separate I/O registers for control, status. 
Data In, and Data Out, which considerably 
simplifies control programming and mini- 
mizes CPU overhead. 

• In asynchronous operations, the Receiver 
detects and handles "break" automatically, 
relieving the CPU of this task. 

• A refined Rx initialization prevents the 
Receiver from starting when in "break" 
state, preventing unwanted interrupts from 
a disconnected USART. 

• At the conclusion of a transmission, TxD 
line will always return to the marking state 
unless SBRK is programmed. 



• Tx Enable logic enhancement prevents a 
Tx Disable command from halting trans- 
mission until all data previously written has 
been transmitted. The logic also prevents 
the transmitter from turning off In the middle 
of a word. 

• When External Sync Detect is programmed. 
Internal Sync Detect is disabled, and an Ex- 
ternal Sync Detect status is provided via a 
flip-flop which clears itself upon a status read. 

• Possibility of false sync detect is minimized 
by ensuring that if double character sync is 
programmed, the characters be contiguously 
detected and also by clearing the Rx register 
to all ones whenever Enter Hunt command is 
issued in Sync mode. 

• As^ long^ the 8251 A is not selected, the 
RD and WR do not affect the Internal opera- 
tion of the device. 

• The 8251 A Status can be read at any time 
but the status update will be inhibited during 
status read. 

• The 8251 A is free from extraneous glitches 
and has enhanced AC and DC characteristics, 
providing higher speed and better operating 
margins. 

• Synchronous Baud rate from DC to 64K. 

• Fully compatible with Intel's new industry 
standard, the MCS-85. 
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FUNCTIONAL DESCRIPTION 

General 

The 8251 A is a Universal Synchronous/Asynchronous Re- 
ceiver/Transmitter designed specifically for the 80/85 Micro- 
computer Systems. Like other I/O devices In a Microcom- 
puter System, its functional configuration is programmed 
by the system's software for maximum flexibility. The 
8251 A can support virtually any serial data technique cur- 
rently in use (including IBM "bi-sync"). 

In a communication environment an interface device must 
convert parallel format system data into serial format for 
transmission and convert incoming serial format data into 
parallel system data for reception. The interface device must 
also delete or insert bits or characters that are functionally 
unique to the communication technique. In essence, the 
interface should appear "transparent" to the CPU, a simple 
input or output of byte-oriented system data. 

Data Bus Buffer 

This 3-state, bidirectional, 8-bit buffer is used to interface 
the 8251 A to the system Data Bus. Data is transmitted or 
received by the buffer upon execution of INput or OUTput 
instructions of the CPU. Control words. Command words 
and Status information are also transferred through the 
Data Bus Buffer. The command status and data in, and 
data out are separate 8-bit registers to provide double 
buffering. 

This functional block accepts inputs from the system Con- 
trol bus and generates control signals for overall device 
operation. It contains the Control Word Register and Com- 
mand Word Register that store the various control formats 
for the device functional definition. 



RESET (Reset) 

A "high" on this input forces the 8251 A into an "Idle" 
mode. The device will remain at "Idle" until a new set of 
control words is written into the 8251A to program its 
functional definition. Minimum RESET pulse width is 
6 tcY (clock must be running). 



C/D (Control/Data) 

This input, in conjunction with the WR and RD inputs, 
informs the 8251 A that the word on the Data Bus is either 
a data character, control word or status information. 
1 = CONTROL/STATUS = DATA 

CS (Chip Select) 

A "low" on this input selects the 8251 A. No reading or 
writing will occur unless the device is selected. When CS is 
high, the Data Bus in the float state and TO and WR will 
have no effect on the chip. 
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Figure 3. 8251A Block Diagram Showing Data 
Bus Buffer and Read/Write Logic 
Functions 



CLK (Clock) 

The CLK input is used to generate internal device timing 
and is normally connected to the Phase 2 (TTL) output of 
the 8224 Clock Generator. No external inputs or outputs 
are referenced to CLK but the frequency of CLK must be 
greater than 30 times the Receiver or Transmitter data 
bit rates. 
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WR (Write) 

A "low" on this input informs the 8251 A that the CPU is 
writing data or control words to the 8251 A. 



RD (Read) 

A "low" on this input informs the 8251A that the CPU is 
reading data or status information from the 8251 A. 



Modem Control 

The 8251A has a set of control inputs and outputs that can 
be used to simplify the interface to almost any Modem. The 
Modem control signals are general purpose in nature and 
can be used for functions other than Modem control, if 
necessary. 
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DSR (Data Set Ready) 

The DSR input signal is a general purpose, 1-bit inverting 
input port. Its condition can be tested by the CPU using a 
Status Read operation. The DSR input is normally used to 
test Modem conditions such as Data Set Ready. 

DTR (Data Terminal Ready) 

The DTR output signal is a general purpose, 1-bit inverting 
output port. It can be set "low" by programming th e ap- 
propriate bit in the Command Instruction word. The DTR 
output signal is normally used for Modem control such as 
Data Terminal Ready or Rate Select. 

RTS (Request to Send) 

The RTS output signal is a general purpose, 1-bit inverting 
output port. It can be set "low" by programming the ap- 
propriate bit in the Command Instruction word. The RTS 
output signal is normally used for Modem control such as 
Request to Send. 

CIS (Clear to Send) 

A "low" on this input enables the 8251 A to transmit 
serial data if the Tx Enable bit in the Command byte is 
set to a "one." If either a Tx Enable off or CTS off condi- 
tion occurs while the Tx is In operation, the Tx will 
transmit all the data in the USART, written prior to Tx 
Disable command before shutting dowa^ On the 8251 A/ 
S2657 if CTS off or Tx Enable off condrtion occurs before 
the last character written appears in the serial bit stream, 
that character will be transmitted again upon CTS on or Tx 
Enable on condition. 

Transmitter Buffer 

The Transmitter Buffer accepts parallel data from the Data 
Bus Buffer, converts it to a serial bit stream, inserts the 
appropriate characters or bits (based on the communica- 
tion technique) and outputs a composite serial strea m of 
data on the TxD output pin on the falling edge of TxC. 
Th e tra nsmitter will begin transmission upon being enabled 
if CfE = 0. The TxD line will be held in the marking 
state Immediately upon a master Reset or when Tx Enable/ 
CTSofforTxEMPTY. 

Transmitter Controi 

The transmitter Control manages all activities associated 
with the transmission of serial data. It accepts and issues 
signals both externally and internally to accomplish this 
function. 

TxRDY (Transmitter Ready) 

This output signals the CPU that the transmitter is ready to 
accept a data character. The TxRDY output pin can be 
used as an interrupt to the system, since it is masked by 
Tx Disabled, or, for Polled operation, the CPU can check 
TxRDY using a Status Read operation. Jj<RDY is auto- 
matically reset by the leading edge of WR when a data 
character is loaded from the CPU. 

Note that when using the Polled operation, the TxRDY 
status bit is not masked by Tx Enabled, but will only 
indicate the Empty /Full Status of the Tx Data Input 
Register. 



TxE (Transmitter Empty) 

When the 8251 A has no characters to transmit, the Tx EMP- 
TY output will go "high". It resets automatically upon re- 
ceiving a character from the CPU if the transmitter is 
enabled. TxEMPTY can be used to indicate the end of a 
transmission mode, so that the CPU "knows" when to "turn 
the line around" in the half-duplexed operational mode. 

In SYNChronous mode, a "high" on this output indicates 
that a character has not been loaded and the SYNC charac- 
ter or characters are about to be or are being transmitted 
automatically as "fillers". TxEMPTY does not go low 
when the SYNC characters are being shifted out. 
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Figure 4. 8251A Blocic Diagram Showing Modem 
and Transmitter Buffer and Controi 
Functions 



TxC (Transmitter Clock) 

The Transmitter Clock controls the rate at which the char- 
acter is to be transmitted. In the Synchron ous tr ansmission 
mode, the Baud Rate (1x) is equal to the TxC frequency. 
In Asynchronous trans missi on mode the baud rate is a 
fraction of the actual TxC frequency. A portion of the 
mode in struct ion selects this factor; it can be 1, 1/16 or 
1/64 the TxC. 

For Example: 

If Ba ud Rate equals 1 10 Baud, 
TxC equals 110 Hz (1x) 
TxC equals 1.76 kHz (16x) 
TxC equals 7.04 kHz (64x). 

The falling edge of TxC shifts the serial data out of the 
8251 A. 
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Receiver Buffer 

The Receiver accepts serial data, converts this serial input 
td parallel format, checks for bits or characters that are 
unique to the communication technique and sends an 
"assembled" character to the CPU. Serial data is inp ut to 
RxD pin, and is clocked in on the rising edge of RxC. 

Receiver Control 

This functional block manages all receiver-related activities 
which consist of the following features: 

The RxD initialization circuit prevents the 8251A from 
mistaking an unused input line for an active low data 
line in the "break condition". Before starting to receive 
serial characters on the RxD line, a valid "1" must first 
be detected after a chip master Reset. Once this has been 
determined, a search for a valid low (Start bit) is en- 
abled. This feature is only active in the asynchronous 
mode, and is only done once for each master Reset. 

The False Start bit detection circuit prevents false starts 
due to a transient noise spike by first detecting the fall- 
ing edge and then strobing the nominal center of the 
Start bit (RxD = low). 

The Parity Toggle F/F and Parity Error F/F circuits are 
used for parity error detection and set the corresponding 
status bit. 

The Framing Error Flag F/F is set if the Stop bit is 
absent at the end of the data byte (asynchronous mode), 
and also sets the corresponding status bit. 

RxRDY (Receiver Ready) 

This output indicates that the 8251 A contains a character 
that is ready to be input to the CPU. Rx RDY can be con- 
nected to the interrupt structure of the CPU or, for Polled 
operation, the CPU can check the condition of RxRDY 
using a Status Read operation. 

Rx Enable off both masks and holds RxRDY in the Reset 
Condition. For Asynchronous mode, to set RxRDY, the 
Receiver must be Enabled to sense a Start Bit and a com- 
plete character must be assembled and transferred to the 
Data Output Register. For Synchronous mode, to set 
RxRDY, the Receiver must be enabled and a character 
must finish assembly and be transferred to the Data Output 
Register. 

Failure to read the received character from the Rx Data 
Output Register prior to the assembly of the next Rx Data 
character will set overrun condition error and the previous 
character will be written over and lost. If the Rx Data is 
being read by the CPU when the internal transfer is occur- 
ring, overrun error will be set and the old character will be 
lost. 

RxC (Receiver Clock) 

The Receiver Clock controls the rate at which the character 
is to be received. In Synchronous Mo de, t he Baud Rate (1x) 
is equal to the actual frequency of RxC. In Asynchronous 
Mode, the Baud Rate is a fraction of the actual RxC fre- 



quency. A portion of th e mo de instruction selects this 
factor; 1, 1/16 or 1/64 the ^xC. 
For Example: 

Baud Rate equals 300 Baud, if 
RxC equals 300 Hz (1x) 
RxC equals 4800 Hz (16x) 
RxC equals 19.2 kHz (64x). 

Baud Rate equals 2400 Baud, if 
RxC equals 2400 Hz (1x) 
RxC equals 38.4 kHz (16x) 
RxC equals 153.6 kHz (64x). 

Data is sampled into the 8251 A on the rising edge of RxC. 

NOTE: In most communications systems, the 8251A will 
be handling both the transmission and reception operations 
of a single link. Consequently, the Receive a nd T ransmit 
Baud Rates will be the same. Both' TxC and RxC will re- 
quire identical frequencies for this operation and can be 
tied together and connected to a single frequency source 
(Baud Rate Generator) to simplify the interface. 

SYNDET (SYNC Detect)/BRKDET (Break Detect) 

This pin is used in SYNChronous Mode for SYNDET and 
may be used as either input or output, programmable 
through the Control Word. It is reset to output mode low 
upon RESET. When used as an output (internal Sync mode), 
the SYNDET pin will go "high" to indicate that the 8251 A 
has located the SYNC character in the Receive mode. If the 
8251 A is programmed to use double Sync characters (bi- 
sync), then SYNDET will go "high" in the middle of the 
last bit of the second Sync character. SYNDET is auto- 
matically reset upon a Status Read operation. 
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Figure 5. 8251 A Block Diagram Stiowing 

Receiver Buffer and Control Functions 
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When used as an input (external SYNC detect mode), a 
positive going signal will cause the 8251 A to start assem- 
bling data characters on the rising edge of the next RxC. 
Once in SYNC, the "high" Input signal can be removed. 
When External SYNC Detect Is programmed, the Internal 
SYNC Detect is disabled. 

BREAK DETECT (Async Mode Only) 

This output will go high whenever the receiver remdins low 
through two consecutive stop bit sequences (including the 
start bits, data bits, and parity bits). Break Detect may also 
be read as a Status bit. It is reset only upon a master chip 
Reset or Rx Data returning to a "one" state. 

NOTE: On the 8251A/S2657, if the RxData returns to a 
"one" state during the last bit of the next character after 
the break, break detect will latch-up, and the device must 
be cleared by a Chip Reset. 
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Figure 6. 8251 A Interface to 8080 Standard 
System Bus 

DETAILED OPERATION DESCRIPTION 

General 

The complete functional definition of the 8251 A is pro- 
grammed by the system's software. A set of control words 
must be sent out by the CPU to initialize the 8251 A to 
support the desired communications format. These control 
words will program the: BAUD RATE, CHARACTER 
LENGTH, NUMBER OF STOP BITS, SYNCHRONOUS or 
ASYNCHRONOUS OPERATION, EVEN/ODD/OFF PAR- 
ITY, etc. In the Synchronous Mode, options are also pro- 
vided to select either internal or external character synchro- 
nization. 

Once programmed, the 8251 A is ready to perform its com- 
munication functions. The TxRDY output is raised "high" 
to signal the CPU that the 8251A is ready to receive a data 
character from the CPU. This output (TxRDY) is reset 
automatically when the CPU writes a character Into the 
8251 A. On the other hand, the 8251 A receives serial data 
from the MODEM or I/O device. Upon receiving an entire 
character, the RxRDY output is raised "high" to signal the 
CPU that the 8251 A has a complete character ready for the 
CPU to fetch. RxRDY is reset automatically upon the CPU 
data read operation. 



The 8251A cannot begin transmission until the Tx Enable 
(Transmitter Enable) bit is set in the Com mand Instruction 
and it has received a Clear To Send (CTS) input. The TxD 
output will be held in the marking state upon Reset. 

Programming the 8251A 

Prior to starting data transmission or reception, the 8251 A 
must be loaded with a set of control words generated by 
the CPU. These control signals define the complete func- 
tional definition of the 8251A and must immediately fol- 
low a Reset operation (internal or external). 

The control words are split into two formats: 

1. Mode Instruction 

2. Command Instruction 

Mode Instruction 

This format defines the general operational characteristics 
of the 8251A. It must follow a Reset operation (internal or 
external). Once the Mode Instruction has been written into 
the 8251A by the CPU, SYNC characters or Command In- 
structions may be inserted. 

Command instruction 

This lormat defines a status i/vord that is used to control the 
actual operation of the 8251 A. 

Both the Mode and Command Instructions must conform 
to a specified sequence for proper device operation. The 
Mode instruction must be inserted immediately following a 
Reset operation, prior to using the 8251A for data com- 
munication. 

All control words written into the 8251 A after the Mode In- 
struction will load the Command Instruction. Command 
Instructions can be written into the 8251 A at any time in 
the data block during the operation of the 8251 A. To re- 
turn to the Mode Instruction format, the master Reset bit 
in the Command Instruction word can be set to initiate an 
internal Reset operation which automatically places the 
8251A back into the Mode Instruction format. Command 
Instructions must follow the Mode Instructions or Sync 
characters. 
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Figure 7. Typical Data Blocic 
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Mode Instruction Definition 

The 8251A can be used for either Asynchronous or Syn- 
chronous data connmunicatlon. To understand how the 
Mode Instruction defines the functional operation of the 
8251 A, the designer can best view the device as two sepa- 
rate components sharing the same package, one Asynchro- 
nous the other Synchronous. The format definition can be 
changed only after a master chip Reset. For explanation 
purposes the two formats will be isolated. 

NOTE: When parity is enabled it is not considered as one of 
the data bits for the purpose of programming the word 
length. The actual parity bit received on the Rx Data line 
cannot be read on the Data Bus. In the case of a pro- 
grammed character length of less than 8 bits, the least 
significant Data Bus bits will hold the data; unused bits are 
"don't care" when writing data to the 8251 A, and will be 
"zeros" when reading the data from the 8251A. 



Asynchronous Mode (Tranwnission) 

Whenever a data character is sent by the CPU the 8251 A 
automatically adds a Start bit (low level) followed by the 
data bits (least significant bit first), and the programmed 
number of Stop bits to each character. Also, an even or 
odd Parity bit is inserted prior to the Stop bit(s), as de- 
fined by the Mode Instruction. The character is then trans- 
mitted as a serial data stream on the TxD output. The serial 
data is shifted out on the falling edge of TxC at a rate equal 
to 1, 1/16, or 1/64 that of the TxC, as defined by the Mode 
Instruction. BREAK characters can be continuously sent to 
the TxD if commanded to do so. 

When no data characters have been loaded into the 8251A 
the TxD output remains "high" (marking) unless a Break 
(continuously low) has been programmed. 



Asynchronous Mode (Receive) 

The RxD line is normally high. A falling edge on this line 
triggers the beginning of a START bit. The validity of this 
START bit is checked by again strobing this bit at its nom- 
inal center (16X or 64X mode only). If a low is detected 
again, it is a valid START bit, and the bit counter will 
start counting. The bit counter thus locates the center of 
the data bits, the parity bit (if it exists) and the stop bits. 
If parity error occurs, the parity error flag is set. Data and 
pari ty b its are sampled on the RxD pin with the rising edge 
of RxC. If a low level is detected as the STOP bit, the 
Framing Error flag will be set. The STOP bit signals the end 
of a character. Note that the receiver requires only one stop 
bit, regardless of the number of stop bits programmed. This 
character is then loaded into the parallel I/O buffer of the 
8251 A. The RxRDY pin is raised to signal the CPU that a 
character is ready to be fetched. If a previous character has 
not been fetched by the CPU, the present character replaces 
it in the I/O buffer, and the OVERRUN Error flag is raised 
(thus the previous character is lost). All of the error flags 
can be reset by an Error Reset Instruction. The occurrence 
of any of these errors will not affect the operation of the 
8251 A. 
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Figure 8. Mode Instruction Format, 
Asynchronous Mode 
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Figure 9. Asynchronous Mode 
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Synchronous Mode (Transmission) 

The TxD output is continuously high until the CPU sends 
its first character to the 8251 A which usually is a SYNC 
character. When the CTS line goes low, the first character 
is serially transmitt ed ou t. All characters are shifted out on 
the falling edge of TxC. Data is shifted out at the same 
rate as the TxC. 

Once transmission has starte d, the data stream at the TxD 
output must continue at the TxC rate. If the CPU does not 
provide the 8251 A with a data character before the 8251 A 
Transmitter Buffers become empty, the SYNC characters 
(or character if in single SYNC character mode) will be 
automatically inserted in the TxD data stream. In this case, 
the TxEMPTY pin is raised high to signal that the 8251 A Is 
empty and SYNC characters are being sent out. TxEMPTY 
does not go low when the SYNC is being shifted out (see 
figure below). The TxEMPTY pin is internally reset by a 
data character being written into the 8251 A. 
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Synchronous Mode (Receive) 

In this mode, character synchronization can be internally 
or externally achieved. If the SYNC mode has been pro- 
grammed, ENTER HUNT command should be included In 
the first command instruction word written. Da ta on the 
RxD pin Is then sampled in on the rising edge of RxC. The 
content of the Rx buffer is compared at every bit boundary 
with the first SYNC character until a match occurs. If the 
8251 A has been programmed for two SYNC characters, the 
subsequent received character is also compared; when both 
SYNC characters have been detected, the USART ends the 
HUNT mode and is In character synchronization. The 
SYNDET pin is then set high, and is reset automatically by 
a STATUS READ. If parity Is programmed, SYNDET 
will not be set until the middle of the parity bit Instead of 
the middle of the last data bit. 

In the external SYNC mode, synchronization Is achieved by 
applying a high level on the SYNDET pin, thus forcing the 
8251 A out of th e HU NT mode. The high level can be 
removed aftei" one RxC cycle. An ENTER HUNT command 
has no effect In the asynchronous mode of operation. 

Parity error and overrun error are both checked in the same 
way as in the Asynchronous Rx mode. Parity Is checked 
when not in Hunt, regardless of whether the Receiver is 
enabled or not. 

The CPU can command the receiver to enter the HUNT 
mode if synchronization is lost. This will also set all the 
used character bits in the buffer to a "one", thus prevent- 
ing a possible false SYNDET caused by data that happens 
to be in the Rx Buffer at ENTER HUNT time. Note that 



the SYNDET F/F is reset at each Status Read, regardless of 
whether internal or external SYNC has been programmed. 
This does not cause the 8251 A to return to the HUNT 
mode. When in SYNC mode, but not in HUNT, Sync Detec- 
tion is still functional, but only occurs at the "known" 
word boundaries. Thus, if one Status Read indicates SYN- 
DET and a second Status Read also indicates SYNDET, 
then the programmed SYNDET characters have been re- 
ceived since the previous Status Read. (If double character 
sync has been programmed, then both sync characters have 
been contiguously received to gate a SYNDET indication.) 
When external SYNDET mode is selected, internal Sync 
Detect is disabled, and the SYNDET F/F may be set at 
any bit boundary. 
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Figure 10. Mode instruction Format, 
Synchronous Mode 
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Figure 11. Data Format, Synciironous Mode 
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COMMAND INSTRUCTION DEFINITION 

Once the functional definition of the 8251 A has been pro- 
grammed by the Mode Instruction and the Sync Characters 
are loaded (if In Sync Mode) then the device is ready to be 
used for data communication. The Command Instruction 
controls the actual operation of the selected format. Func- 
tions such as: Enable Transmit/Receive, Error Reset and 
Modem Controls are provided by the Command Instruction. 

Once the Mode Instruction has been written into the 8251 A 
and Sync characters inserted, if necessary, then all further 
"control writes" (C/D = 1) will load a Command Instruc- 
tion. A Reset Operation (internal or external) will return 
the 8251 A to the Mode Instruction format 



STATUS READ DEFINITION 

In data commufiication systems it is often necessary to 
examine the "status" of the active device to ascertain if 
errors have occurred or other conditions that require the 
processor's attention. The 8251A has facilities that allow 
the programmer to "read" the status of the device at any 
time during the functional operation. (The status update is 
inhibited during status read). 

A normal "read" command is issued by the CPU with C/D = 1 
to accomplish this function. 

Some of the bits in the Status Read Format have identical 
meanings to external output pins so that the 8251 A can be 
used in a completely Polled environment or in an interrupt 
driven environment. TxRDY is an exception. 



IR RTS ER SBRK RkE DTR TkEN 



TRANSMIT ENABLE 
1 - tnabic 
• ditable 



DATA TERMINAL 

READY 

"h.flh" will force DTR 
output to Xtro 



RECEIVE ENABLE 
1 • anabte 
• diMble 



SEND BREAK 

CHARACTER 

1 =■ (orcei T«D "law" 

' normal optratton 



ERROR RESET 

1 ' ratat arror flags 

PE. OE. FE 



REQUEST TO SEND 
•high" Mill lofca RTS 
Output to rero 



INTERNAL RESET 
"high" returni a251A to 
Mode Inilruclion Format 



ENTER HUNT MODE* 
1 • anabia March for Sync 
Charactart 



• (HAS NO EFFECT 
IN ASYNCMODE) 



Not»: Error Reset must be performed whenever Rx Enable 
and Enter Hunt are programnr>ecl. 



Figure 12. Command Instruction Format 



Note that status update can have a maximum delay of 28 
clock periods from the actual event affecting the status. 



DSR SVNDET 



PE TxEMrrV RkRDV T«RDY 



SAME DEFINITIONS AS I/O PINS 



PARITY ERROR 
Thfl PE flag it tat whan a parity 
trror it datactad. It is ratat by 
tha ER bit of the Command 
instruction. PE does not inhibit 
operation of tha 8251 A. 






OVERRUN ERROR 
Tha OE flag it tat whan tha CPU 
does not read a character before 
tfte next one tMcomet available. 
It rs reset by the ER bit of the 
Command Instruction OE does 
not inhibit operation of the 8251 A 
however, the previously overrun 
character is lost 



FRAMING ERROR (Atync only) 
The FE flag ii set when a valid 
Stop bit IS not detected at the 
end of every character It is reset 
by the ER bit of the Command 
Instruction FE does not inhibit 
the operation of the 8251A. 



DATA SET READY: Indicates 
that the DSR it at a laro level. 



Note 1 : 



TxRDY status bit has different meanings from the 
TxRDY output pin*. The former is not conditioned 
by CTS and TxEN; the latter is conditioned by both 
errand TxEN. 
i.e. TxRDY status bit = DB Buffer Empty 

TxRDY pin out = DB Buffer Empty •(CTS=0)- 

lTxEN = 1) 



Figure 13. Status Read Format 
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APPLICATIONS OF THE 8251 A 



ADDRESS BUS 



CONTROL BUS 



MS 



RkD 
TkO 
RiC 



ZH 



-I EIATOTTL L» 
, CONVERT , 

••' (OPT) *- 

t J 



BAUD RATE 
GENERATOR 




Figure 14. Asynchronous Serial Interface to CRT 
Terminal, DC — 9600 Baud 



ADDRESS BUS 



CONTROL BUS 



MI 



R»0 
T«D 
DSR 
DTR 



8251A CTS >• 
RTS >- 



fiC 



ASYNC 
MODEM 



BAUD 

RATE 

GENERATOR 



PHONE 
LINE 

INTER- 
FACE 



TELEPHONE 
LINE 



Figure 16. Asynchronous Interface to Telephone 
Unes 



ADDRESS BUS 



5 



CONTROL BUS 



MH 



RkD 

T«D 

8251A ffl^ 



zx 



SYNCHRONOUS 

TERMINAL 

OR PERIPHERAL 

DEVICE 



Figure 15. Synchronous Interface to Terminal or 
Peripheral Device 



AODRbSS BUS 



CONTROL BUS 



I r 



ffiS 



RxD 

TkD 

lA 

SYNDET 

CTS 
RT5 
OSA 
DTft 



SYNC 
MODEM 



PHONE 
LINE 

INTER- 
FACE 



TELEPHONE 
LINE 



Figure 17. Synchronous interface to Telephone 
Lines 
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ABSOLUTE MAXIMUM RATINGS* 



Ambient Temperature Under Bias C to 70 C 

Storage Temperature -65°C to +150°C 

Voltage On Any Pin 

With Respect to Ground -0.5V to +7V 

Power Dissipation 1 Watt 



'NOTICE: Stresses above those listed under "Absolute 
Maximum Ratings" may cause permanent damage to the 
device. This is a stress rating only and functional opera- 
tion of the device at these or any other conditions above 
those indicated in the operational sections of this specifi- 
cation is not implied. Exposure to absolute maximum 
rating conditions for extended periods may affect device 
reliability. 



D.C. CHARACTERISTICS (Ta = o°c to icfc, Vcc = s.ov ±5%. gnd = ov) 



Symbol 


Parameter 


MIn. 


Max. 


Unit 


Test Conditions 


V|L 


Input Low Voltage 


-0.5 


0.8 


V 




V|H 


Input High Voltage 


2.2 


Vcc 


V 




Vol 


Output Low Voltage 




0.45 


V 


loL = 2.2 mA 


VOH 


Output High Voltage 


2.4 




V 


•oh =-400mA 


'OFL 


Output Float Leakage 




±10 


MA 


VoUT = Vcc TO 0.45V 


'iL 


Input Leakage 




±10 


HA 


V|N = Vcc TO 0.45V 


•cc 


Power Supply Current 




100 


mA 


All Outputs = High 




CAPACITANCE (Ta == 25''C. Vcc = gnd = ov) 



Symbol 


Parameter 


Min. 


Max. 


Unit 


Test Conditions 


C|N 


Input Capacitance 




10 


pF 


fc^lMHz 


Ci/o 


I/O Capacitance 




20 


PF 


Unmeasured pins returned to GND 



A.C. CHARACTERISTICS (Ta = O'C to 70X. Vcc = 5.ov ±5%. gnd = ov) 

Bus Parameters (Note 1 ) 
READ CYCLE 



Symbol 


Parameter 


MIn. 


Max. 


Unit 


Test Conditions 


tAR 


Address Stable Before READ (CS. C/D) 


50 




ns 


Note 2 


tRA 


Address Hold Time for READ (CS, C/D) 


50 




ns 


Note 2 


tRR 


READ Pulse Width 


250 




ns 




tRD 


Data Delay from READ 




250 


ns 


3,Ci_«150pF 


tDF 


READ to Data Floating 


10 


100 


ns 
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A.C. CHARACTERISTICS (Continued) 



WRITE CYCLE 



Symbol 


Parameter 


MIn. 


Max. 


Unit 


Test Conditions 


tAW 


Address Stable Before WRITE 


50 




ns 




tWA 


Address Hold Time for WRITE 


50 




ns 




tww 


WRITE Pulse Width 


250 




ns 




tow 


Data Set Up Time for WRITE 


150 




ns 




two 


Data Hold Time for WRITE 


50 




ns 




tRV 


Recovery Time Between WRITES 


6 




tcv 


Note 4 



OTHER TIMINGS 



Symbol 


Parameter 


Min. 


Max. 


Unit 


Test Conditions 


tCY 


Clock Period 


320 


1350 


ns 


Notes 5, 6 


V 


Clock High Pulse Width 


140 


tCY-90 


ns 




t^ 


Clock Low Pulse Width 


90 




ns 




tR.tF 


Clock Rise and Fall Time 




20 


ns 




tDTx 


TxD Delay from Falling Edge of TxC 




1 


^s 




fTx 


Transmitter Input Clock Frequency 

Ix Baud Rate 

16x Baud Rate 

64x Baud Rate 


DC 
DC 
DC 


64 
310 
615 


kHz 
kHz 
kHz 




tTPW 


Transmitter Input Clock Pulse Width 
Ix Baud Rate 
16xand64x Baud Rate 


12 

1 




tCY 
tCY 




tTPO 


Transmitter Input Clock Pulse Delay 
Ix Baud Rate 
16x and 64x Baud Rate 


15 
3 




tCY 
tCY 




fRx 


Receiver Input Clock Frequency 

IxBaud Rate 

16x Baud Rate 

64x Baud Rate 


DC 
DC 
DC 


64 
310 
615 


kHz 
kHz 
kHz 




tRPW 


Receiver Input Clock Pulse Width 
Ix Baud Rate 
16x and 64x Baud Rate 


12 

1 




tCY 
tCY 




tRPD 


Receiver Input Clock Pulse Delay 
Ix Baud Rate 
16x and 64x Baud Rate 


15 
3 




tCY 
tCY 




tTxRDY 


TxRDY Pin Delay from Center of last Bit 




8 


tCY 


Note? 


tTxRDY CLEAR 


TxRDY ; from Leading Edge of WR 




6 ^ 


^CY 


Note? 


tRxRDV 


RxRDY Pin Delay from Center of last Bit 




24 


tCY 


Note? 


tRxRDY CLEAR 


RxRDY 1 from Leading Edge of RD 




6 


tcY 


Note? 


tis 


Internal SYNDET Delay from Rising 
Edge of RxC 




24 


tcY 


Note 7 


tES 


External SYNDET Set-Up Time Before 
Falling Edge of RxC 


16 




tCY 


Note? 


tTxEMPTY 


Tx EMPTY Delay from Center of Last Bit 


20 




tCY 


Note? 


twc 


Control Delay from Rising Edge of 
WRITE (TxEn,DTR,RTS) 


8 




tcY 


Note? 


tCR 


Control to READ Set-Up Time (DSR, CTS) 


20 




tCY 


Note? 
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A.C. CHARACTERISTICS (Continued) 



NOTES: 

1. AC timings measured Vqh = 2.0. Vql ^ 0.8. and with load circuit of Figure 1. 

2. Chip Select (CS) and Command/Data (C/D) are considered as Addresses. 

3. Assumes that Address is valid t}efore Roi. 

4. This recovery time is for Mode Initialization only. Write Data is allowed only when TxRDY = 1. Recovery Time between Writes for 
Asynchronous Mode Is 8 tcv and for Synchronous Mode is 16 tcv- 

5. The TxC and RxC frequencies have the following limitations with respect to CLK: For 1 x Baud Rate, f jx or fpx ^ 1/(30 ^Cy): Pof l^x and 
64x Baud Rate, fjx or fpx < 1/(4.5" tcv)- 

6. Reset Pulse Width = 6 tcv minimum; System Clock must l>e running during Reset. 

7. Status update can have a maximum delay of 28 clock periods from the event affecting the status. 



TYPICAL A OUTPUT DELAY VS. A CAPACITANCE (pF) 




Section 
4 



A.C. TESTING INPUT, OUTPUT WAVEFORM 



A.C. TESTING LOAD CIRCUIT 



INPUT/OUTPUT 




A C TESTING INPUTS ARE DRIVEN AT 2 4V FOR A LOGiC ' 1 AND 45V FOR 
A LOGIC TIMING MEASUREMENTS ARE MADE AT 2.0V FOR A LOGIC 1 
ANDOev FOR A LOGIC 
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WAVEFORMS 



SYSTEM CLOCK INPUT 




CLOCK ♦ 


-^^ 


rTI 


r^ / 



TRANSMITTER CLOCK AND DATA 

rrw» 



T;^! (la MOOD 



T*"-oo., wiAAAAAAAAAAAAAAAAAA/WWVWWWWWVV 

r*~*OT)C loTX 



RECEIVER CLOCK AND DATA 



-\z. 



iTISdKMOOE) 



(Ra BAUO COUNTER STARTS HERE) 
START BIT 



• RaC PERIODS 
(16«MO0E» 



-16 RaC PERIODS (16a MODE) - 



isc„.«oDc, W\/V\AAAAA>\A/WWW\AAAAA/WWWWVWV\A 






\. 



JC 



WRITE DATA CYCLE (CPU -► USART) 

TaRDY 










/ 


> 










~J 


tT.RDY CLEAR 

-^1 


^ 


OONTCARE 




i""' 'A 


^<M, 




h 


■ tow — 


T^ DATASTA8L 








tAW 




Tcri 


c/0 




\ 










-H 


ei 




N 


XmP 


tv»Ay 




1 



READ DATA CYCLE (CPU <- USART) 



RaROV 


/ 






"^ 












H 


tRBROVCLEAR| 


n 


DATA FLOAT 




r" i 


k 




"1 h 


-tRD — 


1^.0, 




>ATA OUT ACTIVE 










ij 






tAR 




^tRA 




oe 




N 




/ 




tAR 




„— 




ei 




^ 








/ 
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WAVEFORMS (Continued) 



WRITE CONTROL OR OUTPUT PORT CYCLE (CPU -> USART) 



DTR, RTS ' 

(NOTE =11 . 



C/5 



t-»ww^t: 



c^ 



l-« — tow — 



READ CONTROL OR INPUT PORT (CPU ^ USART) 



OSR.CTS 
(NOTE»2) . 



DATA OUT 

(D.B.) 



I- tCR J 



-\ h"i 



^• 



-^• 



ir-h' 



N0TE«1: T^g INCLUDES THE RESPONSE TIMING OF A CONTBOL BYTE. 
N0TE«2: T^^ INCLUDES THE EFFECT OF CTS ON THE TkENBL CIRCUITRY. 




TRANSMITTER CONTROL AND FLAG TIMING (ASYNC MODE) 




cT5~i ': 


tTnEMPTY-* 


. \ 


i 




r 




■ 

i 




. 


T« EMPTY ' 




tk ready 


^ 








ISTATUS BIT) 


L r^ 


[ / 1 




[ 


/ 






T. READY / '[ r^ 


tTuRDY*- 


H \ 






1 ^ 


"'"'' f WfOATAI WrDATA2 


WrDATA3 Wr D 


^TA4 








C/D / \ \ 


r^ 


/ 


\ 


/ 




1 




1 \ 




Wr TkEn 














WrSBRK 




WT vi i 


J ! 


Ln . 


! 


[f\. ] 


Ik 




^ M 




V 




V "^ _ 






^___i 


T.OATA \[XL 


Oiw}\nnuw \wdinu' vjlxx 


n , 


EXAMPLE FORMAT 


DATA 
- 7 BIT CKA 


CHAR1 
RACTERM 


DATA 
ITH PARI 


CHAR 
TY4 3 


2 D 
STOP BIT 


f^TA CHAR 3 
S. 




^ ^DATA 
•2 

11 


CHAR 4 

i 


1 
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WAVEFORMS (Continued) 



RECEIVER CONTROL AND FLAG TIMING (ASYNC MODE) 




^K^ 



TRANSMITTER CONTROL AND FLAG TIMING (SYNC MODE) 



n 



MAW K INC ST ATI 




T« OAT* 
iXAUrtC HJMIAT • i BIT CNANACTf R ntlTM PAHlTV. 2 SYNC CHAMACTfKt 



^\£immmBL''' 



RECEIVER CONTROL AND FLAG TIMING (SYNC MODE) 



li NOV (PIN) 



i — 7 T 



_r 



1L 



n. 



wur 






J 



-CHAM ASSVBCCINS 



fH 



Mr 




ur 



■l/I 



E'^ 



TIJ 



\_r 



M/ 



A 



JUUUU" 



V 



L_^ 



V^ 



CHAR A«SV 



(XITMUNTMOOC / 
UT SVN OCT (STATUS BIT) 



«T 



SET tVNMT ISTATUB tlTl 
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MASTER RESET FEATURE 

A Master Reset of all computer hardware may be accomplished by depressing the solid colored 
RED keys located on either side of the alphanumeric keyboard. 

CURSOR CONTROL KEYS 

There are four cursor control keys located on every SuperBrain II. These keys are located on the 
right-hand side of the numeric keypad. These keys will transmit codes to any program running on 
the SuperBrain II. These codes may in turn be interpreted by the program to result in cursor 
movement on the screen. It is important to know that these keys will not produce cursor 
movement when you are in the operating system mode. The reason for this is that CP/M does not 
define any use of cursor positioning on the screen. As such, depression of these keys while in the 
operating system mode will result in the control codes assigned to the individual keys being 
displayed as control codes on the screen. 

ACCESSING TIME/DATE DATA 

Accessing the TIME/DATE data is accomplished by reading the appropriate port (31 H through 
3CH as specified in the Table of I/O Ports in this section). If the real time clock is being updated 
when the read is attempted, the low order four bits returned will be 1111, indicating a 
hexadecimal F. The read must be retried if this occurs until a correct value is returned. The 
subroutine program that follows illustrates one way to do this. It is written in MBASIC. 

2000 REM SuperBrain II Time of Day Routine 

2010 REM 

2020 REM This subroutine returns the time-of-day which is currently set in the SuperBrain II TOD 

2030 REM clock. The time is returned in the variable T$. It is a string of length 10 where the 

2040 REM format is HH:MM:SS:T. 

2050 REM 

2060 T$ = " " 

2070 FOR I = 6 to STEP - 1 

2080 V = (INP(&H31 + I) AND &HF) 

2090 IF V = 15 THEN 2080 

2100 T$ = T$ + MID$(STR$(V),2) 

2110 IF I MOD 2 = 1 THEN T$ = T$ + "•" 

2120 RETURN 
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INTERFACING INFORMATION 

RS232C SERIAL INTERFACE 

The following chart illustrates the pinouts for the MAIN and AUXILIARY serial ports and the 
direction of signal flow. 

SUPERBRAIN II SERIAL PORT PIN ASSIGNMENTS 



MAIN PORT 






PIN# 


ASSIGNMENT 


DIRECTION 


1 


GND 


- 


2 


TRANSMITTED DATA 


(FROM SB) 


3 


RECEIVED DATA 


(TO SB) 


4 


REQUEST TO SEND 


(FROM SB) 


5* 


CLEAR TO SEND 


(TO SB) 


6 


DATA SET READY 


(TO SB) 


7 


GND 


- 


15 


TRANSMIT CLOCK 


(TO SB) 


17 


RECEIVE CLOCK 


(TO SB) 


20 


DATA TERMINAL READY 


(FROM SB) 


22 


RING INDICATOR 


(TO SB) 


24 


CLOCK 


(FROM SB) 


*Pin 5 must be at a high level at the connector in order for 


successful transn' 


AUXILIARY PORT 






PIN# 


ASSIGNMENT 


DIRECTION 


1 


GND 


— 


2 


RECEIVED DATA 


(TO SB) 


3 


TRANSMITTED DATA 


(FROM SB) 


7 


GND 


~ 


20 


DATA TERMINAL READY 


(TO SB) 



BUS ADAPTOR INTERFACE 

The SuperBrain II contains a Z80 bus interface to the main processor bus. These signals occupy 
the lower 34 pins of a 50 pin connector and are shown on the following pages. 

When using this interface, it is recommended that all signals be buffered so as not to excessively 
load the main processor bus. The external bus should ONLY be utilized for I/O devices using 
addresses 80 to FFH. Memory mapped I/O is NOT possible for user applications since the 
SuperBrain II is internally configured for 64K of RAM. 

PIN CONNECTIONS FOR EXTERNAL BUS 



PIN 




INPUT OR 


NO. 


SIGNAL NAME 


OUTPUT 


1 


OUT* 


OUTPUT 


2 


A11 


OUTPUT 


3 


WR* 


OUTPUT 


4 


A14 


OUTPUT 


5 


RD* 


OUTPUT 


6 


D4 


BOTH 


7 


IN* 


OUTPUT 


8 


D7 


BOTH 



DESCRIPTION 

PERIPHERAL WRITE STROBE OUTPUT 

ADDRESS OUTPUT 

MEMORY WRITE STROBE OUTPUT 

ADDRESS OUTPUT 

MEMORY READ STROBE OUTPUT 

BIDIRECTIONAL DATA BUS 

PERIPHERAL READ STROBE OUTPUT 

BIDIRECTIONAL DATA BUS 
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PIN CONNECTIONS FOR EXTERNAL BUS (continued) 



PIN 




INPUT OR 


NO. 


SIGNAL NAME 


OUTPUT 


9 


GND 


N/A 


10 


N/A 


N/A 


11 


: A10 


: OUTPUT 


12 


: SYSRES 


: OUTPUT 


13 


: AO 


: OUTPUT 


14 


: D6 


: BOTH 


15 


: A12 


: OUTPUT 


16 


: A13 


: OUTPUT 


17 


: A15 


: OUTPUT 


18 


: D3 


BOTH 


19 


: D5 


BOTH 


20 


: DO 


BOTH 


21 


: A8 


OUTPUT 


22 


: A4 


OUTPUT 


23 


: D2 


BOTH 


24 


: A1 


OUTPUT 


25 


: A3 


OUTPUT 


26 


: A5 


OUTPUT 


27 


: A9 


OUTPUT 


28 


: A7 


OUTPUT 


29 


: A2 


OUTPUT 


30 


: A6 


OUTPUT 


31 


: D1 


BOTH 


32 


: -I-5V 


N/A 


33 


■ GND 


N/A 


34 


GND 


N/A 


35 


GND 


N/A 


36 


-t-12V 


N/A 


37 


AUX RX DATA 


INPUT 


38 


MAINTXCLK 


INPUT 


39 


MAINRXGLK 


INPUT 


40 


MAIN RX DATA 


INPUT 


41 


MAIN GTS 


INPUT 


42 


AUX DSR 


INPUT 


43 


MAIN RTS 


OUTPUT 


44 


MAIN DSR : 


INPUT 


45 


MAIN CLK 


OUTPUT 


46 


AUX TX DATA 


OUTPUT 


47 


MAIN Rl 


INPUT 


48 


-12V 


N/A 


49 


MAIN DTR 


OUTPUT 


50 


MAIN TX DATA 


OUTPUT 



DESCRIPTION 

SIGNAL GROUND 

N/A 

ADDRESS OUTPUT 

SYSTEM RESET OUTPUT, LOW DURING POWER UP 

INITIALIZE OR RESET DEPRESSED 

ADDRESS OUTPUT 

BIDIRECTIONAL DATA BUS 

ADDRESS OUTPUT 

ADDRESS OUTPUT 

ADDRESS OUTPUT 

BIDIRECTIONAL DATA BUS 

BIDIRECTIONAL DATA BUS 

BIDIRECTIONAL DATA BUS 

ADDRESS OUTPUT 

ADDRESS OUTPUT 

BIDIRECTIONAL DATA BUS 

ADDRESS OUTPUT 

ADDRESS OUTPUT 

ADDRESS OUTPUT 

ADDRESS OUTPUT 

ADDRESS OUTPUT 

ADDRESS OUTPUT 

ADDRESS OUTPUT 

BIDIRECTIONAL DATA BUS 

POSITIVE 5 VOLTS (LIMITED CURRENT) 

SIGNAL GROUND 

SIGNAL GROUND 

SIGNAL GROUND 

POSITIVE 12 VOLTS (used for RS232 Receiver bias) 

AUXILIARY PORT RECEIVE DATA 

MAIN PORT TRANSMIT CLOCK 

MAIN PORT RECEIVE CLOCK 

MAIN PORT RECEIVE DATA 

MAIN PORT CLEAR TO SEND 

AUXILIARY PORT DATA SET READY 

MAIN PORT REQUEST TO SEND 

MAIN PORT DATA SET READY 

MAIN PORT CLOCK 

AUXILIARY PORT TRANSMIT DATA 

MAIN PORT RING INDICATOR 

MINUS 12 VOLTS (used for RS232 Receiver bias) 

MAIN PORT DATA TERMINAL READY 

MAIN PORT DATA TRANSMIT 
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TABLE OF I/O PORTS* 



DEVICE* 




PORT 




NO. 


MANUFACTURER 


ADDRESS 


FUNCTION 


KR3600 


STANDARD 

MICROSYSTEMS 

CORP. 


50H 


KEYBOARD CHARACTER (R/0) 


BR1941 


WESTERN 
DIGITAL 


60H 


BAUD RATE GENERATOR (W/0) 


8251A 


INTEL 


40H 


AUXILIARY PORT DATA 






41 H 


AUXILIARY PORT STATUS 






58H 


MAIN PORT DATA 






59H 


MAIN PORT STATUS 


8255 


INTEL 


68H 


8255 PORT A (W/0) 






69H 


8255 PORT B (R/0) 






6AH 


8255 PORT C (W/0) 






6BH 


8255 CONTROL PORT (W/0) 


MM58174 


NATIONAL 


31H 


DAY/DATE CLOCK TENTHS DIGIT (R/0) 




SEMICONDUCTOR 


32H 


DAY/DATE CLOCK UNITS OF SECONDS (R/0) 






33H 


DAY/DATE CLOCK TENS OF SECONDS (R/0) 






34H 


DAY/DATE CLOCK UNITS OF MINUTES (R/W) 






35H 


DAY/DATE CLOCK TENS OF MINUTES (R/W) 






36H 


DAY/DATE CLOCK UNITS OF HOURS (R/W) 






37H 


DAY/DATE CLOCK TENS OF HOURS (R/W) 






38H 


DAY/DATE CLOCK UNITS OF DAYS (R/W) 






39H 


DAY/DATE CLOCK TENS OF DAYS (R/W) 






3AH 


DAY/DATE CLOCK DAY OF THE WEEK (R/W) 






3BH 


DAY/DATE CLOCK UNITS OF MONTHS (R/W) 






3CH 


DAY/DATE CLOCK TENS OF MONTHS (R/W) 






SDH 


DAY/DATE CLOCK LEAP YEAR SETTING (W/0) 






3EH 


DAY/DATE CLOCK START/STOP PORT (W/0) 



•FOR DETAILED DEVICE INFORMATION, CONSULT MANUFACTURER'S DATA SHEETS. 
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AUTOLOAD FEATURE 

Perhaps you wish for your computer to perform the same function upon each operating system 
restart. This is possible with CP/M version 2.2. The command buffer is the area in computer 
memory where the next command to be executed is placed. In normal CP/M systems this buffer is 
empty and, upon operating system restart, the system awaits your command. You may alter this if 
desired, so that the system will execute any program on the disk upon cold or warm reboot. 

In order to implement this autoload feature, you have to change the operating system that is 
stored on the inner two tracks of your diskette. First, make a copy of the program on your 
distribution diskette that will generate the operating system. For the SuperBrain II QD, this 
program is called QDIICPM.COM, for SuperBrain II SD it is called SDIICPM.COM, and for the 
SuperBrain II Jr, it is called SBIICPM.COM. Using the PIP program, enter the following: 

A > PIP AUT0L0AD.COM = SBIICPM.COM <cr> 

SBIICPM.COM is similar to using the SYSGEN utility, except that no SOURCE DRIVE is specified 
when using it. After you have made the copy, you will have to alter its command buffer for the 
autoload capability. The DDT system program will have to be used to do this. It is strongly 
recommended that you become familiar with the DDT program before attempting to alter the 
operating system. See the CP/M DYNAMIC DEBUGGING TOOL (DDT) USER'S GUIDE in this 
manual, for assistance. 

Next enter the program 'AUT0L0AD.COM' with the use of DDT. The correct command is: 

A> DDT AUT0L0AD.COM <cr> 

DDT will then load into the computer's memory and read in your 'AUTOLOAD' program. After you 
have decided on the command you want to be executed upon restart, determine its length. This is 
done by counting the number of characters in the command. If a file nanne and/or parameters are 
included in the command, be sure to include their length(s) in the count. Include any separating 
spaces. For example, if you wanted the directory display, the command is DIR, and its length is 3. 
If instead you wanted to see a directory display of disk A, the command is DIR A: and its length is 
6. 

The CP/M command buffer begins at location 987H. Use the 'S' command to alter the desired 
memory locations with your new command. Place the hexadecimal value of the command length 
in this location. The command itself begins at location 988H, and you may use up to eighty (80) 
characters from that point for the buffer. Notice that if you go beyond that, you will overwrite the 
copyright notice In the operating system. At the end of your command, place the null terminator 
OOH. When inserting the command itself into the memory locations, please note that you must 
enter hexadecimal numbers for the ASCII values of the letters in the command. When finished, 
use the DDT command 'D' to display the results of your action. Make any necessary corrections, 
and then exit to the operating system with CRTL-C. Before you do anything else, you must save 
the memory contents of the 'AUTOLOAD' program. Using CP/M's 'SAVE' function, enter the 
following line at the keyboard: 

A > SAVE 48 AUT0L0AD.COM <cr> 

Let's review what we have done so far. First, we made a copy of the operating system, and called 
it 'AUT0L0AD.COM'. (Incidentally, any other name could have been used as long as the file type 
is '.COM'). Next, we placed a CP/M command into the CP/M command buffer, starting with the 
command length in hexadecimal. We ended with a null byte terminator. Then we exited to the 
operating system and saved the revised program in memory on the disk. Now it is time to 
generate the new operating system. 
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Please be sure that the command in the command buffer is what you want your computer to do 
upon each operating restart, because that is exactly what it will do. Type in the following 
command at the keyboard: 

A > AUTOLOAD <cr> 

From here the operation will be similar to that of the-SYSGEN command. First you will be asked to 
enter a SOURCE DRIVE. Press the RETURN key here; the program itself is carrying the operating 
system. Next enter the DESTINATION DRIVE. Enter your choice, and press the RETURN key 
when the correct diskette has been inserted in the destination drive. If you are using a new 
diskette, make certain that it has been formatted with the FORMAT command. When the 
message FUNCTION COMPLETE is displayed upon the screen, your transfer is done, and you 
should press the RETURN key to reboot the operating system. If you specified Drive A as the 
destination drive, this reboot will incorporate your new modification. If not, replace the diskette in 
Drive A with your destination diskette, and press both RED keys simultaneously. You should now 
have an operating system with an autoload feature. If not, you probably incorrectly entered the 
command in the command buffer. Repeat the above procedure if this is the case. 

WARNING: If you choose drive A as the destination drive and you made an error in altering the 
command buffer, this diskette will contain an unusable copy of the operating system. You will 
have to replace its operating system with a valid copy probably using the SYSGEN command. 
Therefore, it is recommended that you select drive B as your destination drive when altering the 
command buffer. 

Here is a sample session describing the steps needed to alter the command buffer of your 
operating system. Please carefully read the previous section before attempting to alter this 
command buffer. Note that all items in bold type are to be typed in by you. Otherwise, the displays 
are generated by the computer. When you encounter <cr)> , press the RETURN key. 

A > PIP AUT0L0AD.COM = SBIICPM.COM[V] <cr> 

A > DDT AUT0L0AD.COM <cr> 
DDT VER 1 .4 
NEXT PC 
3100 0100 

-S987<cr> 

0987 00 06<cr> 

0988 20 44<cr> 

0989 20 49<cr> 
098A 20 52<cr> 
098B20 20<cr> 
098C20 41<cr> 
098D 20 3A<cr> 
098E 20 00<cr> 
098F 20 .<cr> 
-CONTROL-C 

A SAVE 48 AUT0L0AD.COM <cr> 

A AUTOLOAD <cr> 

SYSGEN VER 1 .X 

SOURCE DRIVE NAME (OR RETURN TO SKIP) <cr> 

DESTINATION DRIVE NAME (OR RETURN TO REBOOT) B<cr> 

FUNCTION COMPLETE 

DESTINATION DRIVE NAME (OR RETURN TO REBOOT) <cr> 

A> 

(Now replace the diskette in drive B into drive A, and depress RED keys.) 
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KEY CLICK 

The key click feature is designed to provide a tone with each key depression. The purpose of the 
feedback is to allow faster data entry by informing the operator whenever a key is depressed. This 
feature can be easily selected during terminal operation or can be automatically selected upon 
system power-up. 

To enable the feedback feature, simply type a Control-B (02H). This will 'toggle' the key click 
feature and turn it on if it is off, or vice versa. The CONFIGUR program will permit you to set the 
click on or off on system power-up, and hence, relieve you of any further action. 

KEY REPEAT 

When a key remains depressed for more than 1 second, the key value will repeat at a rate of 
approximately 30 per second. This will allow faster data entry for applications such as word 
processing, text editing, and program displays where a 'banner' is required. 

TYPE-AHEAD 

The input on DOS version 1 .X is saved if the operator enters data faster than the computer can 
accept it. Up to 1 28 characters are stored when typed, and delivered only when needed. It is now 
possible to enter commands to an application program as it is being loaded from the disk and not 
lose any characters. Your input will appear after the program has been loaded, and the program 
will execute the commands as if you had just entered them. If you type more than 1 28 characters 
ahead of the computer system, the bell will ring. This indicates that the buffer is full, and further 
typing will be ignored by the system. 

NOTE: It should be noted that some programs will not work with the type-ahead feature. An 
example is the DIR command, which displays the directory contents of a diskette. By definition, a 
directory display is interrupted if a key is depressed during the display. If the DIR command 
receives a key from the type-ahead feature, it doesn't know if the key was just entered, or if it 
came from the buffer. In either case, the display is disrupted and a character is lost. Experiment 
with the system to see which programs will not tolerate type-ahead. 

In the event that an error is made, the type ahead buffer can be erased by depressing the 
CONTROL key and the 1 key (on the alphanumeric keyboard only, not the numeric keypad) 
simultaneously. 

CONTROLLING THE VIDEO DISPLAY 

The SuperBrain II allows the user a great degree of flexibility in controlling the video display. The 
user can control where the display is on the screen and the appearance of the displayed 
information. 

Data positioning can be effected either by absolute cursor addressing or memory-mapping. 
Display appearance is controlled by two factors. First, the SuperBrain II has an optional 
character set available to the user. Alternating character sets as well as video attributes can be 
effected on a character by character basis. Second, there are four video attributes. These are: 

* Blinking. 

* Half-intensity. 

* Underlining. 

* Reverse Video. 

Memory-mapping means that a portion of the memory is devoted to use by the screen display. 
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The RAM nnemory location F800H marks the beginning of screen area and this area extends 
through location FFFFH. This memory area is not available for program or data storage. 

The CRT controller performs a direct memory access (DMA) cycle to obtain the screen data, 
relieving the CPU of most screen related functions. When the CRT controller receives certain 
inputs, the display is affected. 

There are two main types of inputs that are meaningful to the CRT controller: escape sequences 
and control codes. An escape sequence is noted when the ASCII representation of ESC (27H) is 
received by the CRT controller and followed by other characters. 

A control code is noted when the CTRL key of the keyboard is held down while another key is 
depressed. The CTRL key functions somewhat like the SHIFT key does. 

ESCAPE SEQUENCES 

The following is a list of escape sequences that have meaning to the CRT controller. 
NOTE: " ^ " is equivalent to ASCII code 7E (Hex) or 126 (decimal). 
SEQUENCE MEANING 

ESC Y row column Absolute cursor addressing. The cursor is positioned to the row 

and column as shown in the screen layout chart in this section. 

ESC^ K Erase to end of line. Data is erased from the current cursor 

position through the end of the current line. 

ESC ^ k Erase to end of screen. Data is erased from the current cursor 

position through the end of the current screen. 

ESC ~ E Display control characters. The transparent mode of operation is 

enabled which means that control codes not normally shown on 
the screen will be displayed. 

ESC "^ D Disable display of control characters. 

ESC "^ B Turns the blinking video attribute on. 

ESC ^ b Turns the blinking video attribute off. 

ESC '^ H Turns the half-intensity attribute on. 

ESC "" h Turns the half-intensity attribute off. 

ESC ^ U Turns the underlining attribute on. 

ESC "^ u Turns the underlining attribute off. 

ESC ^ R Turns the reverse video attribute on. 

ESC ^ r Turns the reverse video attribute off. 

ESC ^ A Makes the entire screen non-reverse video. 

ESC "^ a Makes the entire screen reverse video. 
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ESCAPE SEQUENCES (continued) 

SEQUENCE MEANING 

ESC "^ N Normalizes. Turns all attribute indicators (B, H, U, R) off if they 

are on, beginning with the next character. 

ESC "" g Displays the entirety of what is on the screen as its 

corresponding alternate(s) from the secondary character set. 
This only works if the secondary character EPROM is installed. 

ESC '^ G This reverses the effects of the ESC '^ g escape sequence 

preceeding. 

ESC "" S This sequence reverses the primary and secondary assignments 

of the character sets when an alternate (secondary) character 
set is installed. If set A is primary and set B is secondary, this 
sequence will cause B to be primary and A to be secondary. 

ESC ^ s This reverses the effect on the ESC "^ S sequence preceeding. 

NOTE: Of the escape sequences discussed, the S, G, a, and A options affect the entire screen 
including data on the screen entered prior to this sequence. 

NOTE: The high order bit of the ASCII character is what controls switching between primary 
and secondary character sets. A ''0" is the high order bit selects primary set. A ''1" in the 
high order bit selects the secondary set. 

CONTROL CODES 

The following is a list of the control codes that have meaning to the CRT controller. 

CODE MEANING 

CTRL-A Home cursor — The cursor is positioned at row 1 , column 1 . 

CTRL-F Cursor forward — The cursor is moved one space to the right. 

CTRL-G Ring bell — The audio indicator is activated. 

CTRL-H Cursor back — The cursor is moved one space to the left. 

CTRL-K Cursor up — The cursor is moved up one line. 

CTRL-J Cursor down — The cursor is positioned down one- line. 

CTRL-I Tabbing — The cursor is positioned to the next tab (modulo-8) position. 

CTRL-L Clear screen — Erases the data on the screen and the cursor is moved to row 

1 , column 1 , its home position. 

CTRL-R Redisplays current CP/M command line. 

CTRL-X Clears current CP/M command line. 

CTRL-® Page off/on — video display scrolling is enabled or disabled. Valid during 
operator input only and not subject to user program control. 

CTRL-1 Clears type ahead buffer. 
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VIDEO ATTRIBUTES 



Attributes are set by the SuperBrain II when particular escape sequences (see previous list) are 
received by the Console Out routine of the CP/M BIOS (and subsequently the CRT controller). The 
escape sequence consists of an ESC(ape), followed by a TILDE, followed by a hexadecimal 
representation of the attribute desired. The hexadecimal format is 1 B 7E NN where NN assumes 
the following value as desired. 



42H- 


■B 


61 H- 


- a 


62H- 


■b 


41 H- 


-A 


48H- 


■H 


4EH 


-N 


68H- 


-h 


67H- 


■g 


55H- 


-U 


47H- 


-G 


75H- 


■ u 


53H- 


■ s 


52H- 


■R 


73H- 


■ s 


72H- 


• r 







The following program written in MBASIC language distributed with your SuperBrain II, shows a 
technique for attribute manipulation. 

100 CY = 20 

110 CX = 5 

120 REM Clear screen and then show some of the SuperBrain II video attributes. 

130 REM 

140 PRINTCHR$(12) 

150 REM first line is normal 

160 GOSUB510 

170 PRINT "SuperBrain II Video Attribute Demo" 

180 REM 

190 REM Now turn on inverse video and reprint line. 

200 REM 

210 CX = 7:G0SUB 510 

220 PRINT CHR$(27); " R"; 

230 PRINT "SuperBrain II Video Attribute Demo" 

240 REM 

250 REM Now turn on half intensity and reprint line 

260 REM 

270 REM 

280 CX = 9:GOSUB510 

290 PRINT CHR$(27);" H"; 

300 PRINT "SuperBrain II Video Attribute Demo" 

310 REM 

320 REM Turn inverse back off and turn underlining on 

330 REM 

340 CX = 11:GOSUB510 

350 PRINT CHR$(27); " r"; CHR$(27);" U"; 

360 PRINT "SuperBrain II Video Attribute Demo" 

380 REM 

390 REM Turn half intensity off but leave underlining on 

420 REM 

430 CX = 13:GOSUB510 

450 PRINT CHR$(27);" h"; 

470 PRINT "SuperBrain II Video Attribute Demo" 

471 REM 

472 REM Now normalize the video attributes 
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N' 



473 


REM 


474 


PRINT CHR$(27):" 


480 


PRINT 


490 


PRINT 


500 


END 


510 


Print CHR$(11) 


520 


PRINT CHR(27);"Y 


530 


RETURN 



CHR$(CX + 31);CHR$ = (CY + 31); 



CURSOR POSITIONING FOR DISPLAY CONTROL 

Cursor positioning is easily accomplished using the ESC Y row column escape sequence. The 
proper row, column coordinates can be determined by referencing the SuperBrain II screen 
layout in this section. 

The example program that follows, written in MBASIC, shows one method of accomplishing 
screen control. 

MEMORY MAP/SCREEN INITIALIZATION 

This BASIC program fragment will clear the screen and set the "HOME" position to be memory 
address &HF800. The user can then "POKE" characters into the next 1 ,920 locations of screen 
memory. 

NOTE: Line number 1110 leaves the cursor at the top of the screen. The cursor can, at this time, 
be moved where the user wishes with standard escape sequence cursor positioning commands. 

1090 PRINTCHR$(12); 

1100 FOR I = 1 to 23:PRINT " " :Next I 

1110 PRINT" ";CHR$(1); 

1120 RETURN 

The next example program, also written in MBASIC, shows an example of cursor positioning. 

100 REM Clear the Screen 

110 PRINTCHR$(12) 

120 REM Position the cursor at row 20 column 30 

130 CX = 20 

140 CY = 30 

150 GOSUB2000 

160 PRINT"* -POSITION 20, 30" 

170 REM Position the cursor at row 5 column 20 

180 CX = 5 

190 CY = 20 

200 GOSUB 2000 

210 PRINT"* -POSITION 5, 20" 

220 REM Home cursor and then end 

230 PRINT CHR$(1); 

240 END 

2000 REM Cursor Positioning Subroutine 

2010 REM 

2020 REM This subroutine clears the MBASIC line output character counter 

2030 REM and then positions the cursor at the locations specified by the 

2040 REM variables CX and CY where CX is the line number and CY is the 
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2050 REM column number. These variables must be set by the program before 

2060 REM entering the subroutine 

2070 REM 

2080 REM NOTE: Home position on the screen is row 1 column 1 

2090 REM 

2100 PRINT CHR$(11) 

2110 PRINT CHR$(27);"Y";CHR$(CX + 31);GHR$(CY + 31); 

2120 RETURN 
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00 
CO 

o 

k 

o 



12 3 4 5 6 7 

667890 1234567890 1234S67890«1 234S67890 123456789012345678 '9 012345678901 



2 3 4 5 6 7 8 9 



1 
2 

3 

4 
5 
6 
7 
8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 

21 

22 

23 



9 
10 
11 
12 
13 
14 

15 

16 

17 

18 

19 

20 

21 

22 

23 

24 



80 Characters 



24 
lines 



SCREEN DISPLAY 



STATUt LIME 



This Screen Format of the SuperBrain display area provides an easy method of 
locating and addressing specific screen positions. 

Using the ESC, Y, r, c command, locate both the row character (r = 1 - 24) and 
the column (c = 1 - 80) characters. Example: 



ROW 


COLUMN 


COMMAND 


1 (Home) 


1 


ESC Y sp sp 


2 


5 


ESC y ! $ 


20 


50 


ESC Y 3 Q 



An application programmer may find it helpful to maintain a table of row and 
column numbers with their respective addressing characters as shown on this 
Screen Format. This will provide quick and easy access to specific screen 
positions. 



- 



CO 
CjO 



234f67891 





1234567892 12346678931234567894 




123456789512345 




896123456789 7 12 




34567898 
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INTERPRETING THE ASCII CODE CHART 



The figure below illustrates a conventionally arranged ASCII code chart divided into three 
sections corresponding to control codes (column to 1) upper case characters (columns 2, 3, 4, 
and 5), and lower case characters (columns 4 and 5). 







\ 


\ 


\ 


\ 


'»0 


\ 


\ 


\ 


^ 
^ 
















* 


5 








^4 

i 


^ 

* 


^ 

i 


^1 


column 
row^ 





1 


2 


3 


4 


5 


6 


7 



















NUL 


OLE 


SP 





@ 


P 


\ 


P 















1 


SOH 


DC1 


! 


1 


A 


Q 


a 


q 










1 





2 


STX 


DC2 


•• 


2 


B 


R 


b 


r 










1 




3 


ETX 


cx^a 


# 


3 


c 


S 


c 


s 







1 








4 


EOT 


DC4 


$ 


4 


D 


T 


d 


t 







1 







5 


ENQ 


NAK 


% 


5 


E 


U 


e 


u 







1 


1 





6 


ACK 


SYN 


& 


6 


F 


V 


f 


V 







1 


1 




7 


BEL 


ETB 


' 


7 


G 


w 


g 


w 















8 


BS 


CAN 


( 


8 


H 


X 


h 


X 














9 


HT 


EM 


) 


9 


1 


Y 


i 


y 






9 


1 





10 


LF 


SUB 


• 




J 


z 


i 


z 









1 




11 


VT 


ESC 


+ 


; 


K 


fc 


k 


i 






1 








12 


FF 


FS 


, 


< 


L 


\ 


L 


I 

1 






1 







13 


CR 


GS 


— 


= 


M 


1 


m 


( 






1 


1 





14 


so 


RS 




> 


N 


A 


n 


^ 






1 


1 




15 


SI 


US 


/ 


7 





— 


o 


DEL 



CONTROL CODE CHART 

The following is a list of the hexadecimal equivalents of the control codes. The CONFIGUR 
program accepts only hexadecimal values when reassigning the keypad, so these are listed as a 
programmer convenience. Use caution when reassigning the values on the keypad, and recall 
that you may enter 'R' to restore the pad to its original configuration if you desire. 



Ctrl-A 


01 H 


Gtrl-J 


OAH 


Ctrl-S 


13H 


Ctrl-B 


02H 


Ctrl-K 


OBH 


Ctrl-T 


14H 


Ctrl-C 


03H 


Ctrl-L 


OCH 


Ctrl-U 


15H 


Ctrl-D 


04 H 


Ctrl-M 


ODH 


Ctrl-V 


16H 


Ctrl-E 


05 H 


Ctrl-N 


OEH 


Ctrl-W 


17H 


Ctrl-F 


06 H 


Ctrl-0 


OFH 


Ctrl-X 


18H 


Ctrl-G 


07 H 


Ctrl-P 


10H 


Ctrl-Y 


19H 


Ctrl-H 


08 H 


Ctrl-Q 


11H 


Ctrl-Z 


1AH 


Ctrl-I 


09 H 


Ctrl-R 


12H 







After all corrections have been entered, pressing the 'RETURN' key will save your new 
parameters on the disk. This must be done at the main menu of selections. Then press both RED 
keys when instructed to force a 'cold boot' of the Operating System and properly load your new 
changed parameters. 

Control codes are not displayable unless in the transparent mode. Some of these codes affect the 
state of the terminal when they are received by the display electronics. For example, the code 
SOU causes the cursor to go to the home position, and code DC2 turns on the printer port. Codes 
which have no defined function in the SuperBrain II software are ignored if received. Theset of 64 
upper case alphanumeric characters is sometimes referred to as "compressed ASCII". 
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CONTROL CODE CHART (continued) 

If the terminal is set for upper case operation only (CAPS LOCK), lower case alpha characters 
from the keyboard are automatically translated and displayed as their upper equivalents (columns 
4 and 5). If the DEL code is received, it is ignored. Lower case characters received from the input 
RS-232C port are displayed as lower case. 

The seven bit binary code for each character is divided into two parts in this chart. A four-bit 
number represents the four least significant bits (B1, 82, B3, B4) and a three-bit number 
represents the three most significant bits (85, 86, 87). The chart above also is divided into 8 
columns and 16 rows. This offers two ways of indicating a particular character's code. The 
character code is indicated as either a seven-bit binary number or as a column/row number in 
decimal notation. For example, the character M is represented by the binary number 1001101 or 
the alternative 4/1 3 notation. Similarly, the control code VT is represented by the code 0001 01 1 or 
the alternative 0/11 notation. 



For the Super8rain II, the high order bit is used to determine switching between the primary and 
secondary character sets. This eighth (or high order) bit is not shown in this chart but exists and 
can be manipulated from user programs. 

WORDSTAR CONSIDERATIONS FOR SUPERBRAIN II 

This is to set up a version of WordStar for the Super8rain II that uses the Super8rain II in a 
memory mapped mode. The following variable names are in appendix D of the WordStar manual 
("Terminal Patch Area"). The following items need to be set as indicated: 

User cursor positioning 

routine for nnennory map 
operation. 

Jump to the SuperBrain II 
initialization routine. 

Turn memory map mode on 
Address of video screen RAM. 

Initialize the SuperBrain II 
video memory map. 




0264 


UCRPOS 


JMP 


0304H 


02A4 


INISUB 


JMP 


02E0H 


02B0 


MEMAPV 


DB 


OFFH 


02B1 


MEMADR 


DB 


0F800H 


02E0 


MORPAT 


CALL 


02E8H 


02E3 




DEC 


A 


02E4 




CALL 


0239H 


02E7 




RET 




02E8 




XRA 


A 


02E9 




LXI 


H,0E434H 


02EC 




MVI 


B,18H 


02EE 




MOV 


M,A 


02EF 




INX 


H 


02F0 




DEC 


B 


02F1 




JNZ 


02EEH 


02F4 




LXI 


H.OOOO 


02F7 




SHLD 


0E400H 


02 FA 




SHLD 


0E414H 


02FD 




SHLD 


0E416H 


0300 




SHLD 


0E412H 


0303 




RET 




0304 




XCHG 




0305 




JMP 


0300H 



If the user has the reverse video character set EPROM installed in the secondary character set 
EPROM position, WordStar can also highlight certain itenns by setting the follow/ing value: 



02B3 HIBIV 
6831010 



DB 



OFFH 



Highlight using the high bit 
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1. INTRDDUCTiaSI. 

CP/M is a nonitor control program for microcomputer system development 
which uses IBM-compatible flexible disks for backup storage. Using a computer 
mainframe based upon Intel's 8080 microcomputer^ CP/M provides a general 
environment for program construction, storage, and editing, along with 
assembly and program check-out facilities. An important feature of CP/M is 
that it can be easily altered to execute with any computer configuration v^ich 
uses an Intel 8080 (or Zilog Z-80) Central Processing Unit, and has at least 
16K bytes of main memory with up to four IBM-compatible diskette drives. A 
detailed discussion of the modifications required for any particular hardware 
environment is given in the Digital Research document entitled "CP/M System 
Alteration Guide." Although the standard Digital Research version operates on 
a single-density Intel MDB 800, several different hardware manufacturers 
support their own input-output drivers for CP/M. 

The CP/M monitor provides rapid access to programs through a 
conprehensive file management package. The file subsystem supports a named 
file structure, allowing dynamic allocation of file space as well as 
sequential and random file access. Usirg this file system, a large number of 
distinct programs can be stored in both source and machine ececutable form. 

CP/M also supports a powerful context editor, Intel-compatible assembler, 
and debugger subsystems. Optional software includes a powerful 
Intel-conpatible macro assenbler, symbolic debugger, along with various 
high-level languages. When coupled with CP/M's Console Command Processor, the 
resulting facilities equal or excel similar large computer facilities. 

CP/M is logically divided into several distinct parts: 

BIOS Basic I/O System (hardware dependent) 

BDOS Basic Disk Operating System 

CCP Console Command Processor 

TPA Transient Program Area 

The BIOS provides the primitive operations necessary to access the 
diskette drives and to interface standard peripherals (teletype, CRT, Paper 
Tape Reader/Punch, and user-defined peripherals) , and can be tailored by the 
user for any particular hardware environment by "patching" this portion of 
CP/M. The BDOS provides disk management by controlling one or more disk 
drives containing independent file directories. The BDOS implements disk 
allocation strategies vghich provide fully dynamic file construction v*iile 
minimizing head movement across the disk during access. Any particular file 
may contain any number of records, not exceeding the size of any single disk. 
In a standard CP/M system, each disk can contain up to 64 distinct files. The 
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BDOS has entry points vvhich include the following primitive operations vAiich 
can be progranuTBtically accessed: 

SEARCH Look for a particular disk file by name. 

OPEN Open a file for further operations. 

CLOSE Close a file after processing. 

RENAME Change the name of a particular file. 

READ Read a record from a particular file. 

WRITE Write a record onto the disk. 

SELECT Select a particular disk drive for further 
operations. 

The CCP provides symbolic interface between the user's console and the 
remainder of the CP/M system. The CCP reads the console device and processes 
commands v*iich include listing the file directory, printing the contents of 
files, and controlling the operation of transient programs, such as 
assemblers, editors, and debuggers. The standard commands v*iich are available 
in the CCP are listed in a following section. 

The last s^ment of CP/M is the area called the Transient Program Area 
(TPA) . The TPA holds programs vAiich are loaded fran the disk under command of 
the CCP. During program editing, for example, the TPA holds the CP/M text 
editor machine code and data areas. Similarly, programs created under CP/M 
can be checked out by loading and executing these programs in the TPA. 

It should be mentioned that any or all of the CP/M component subsystems 
can be "overlayed" by an executing program. That is, once a user's program is 
loaded into the TPA, the CCP, BDOS, and BIOS areas can be used as the 
program's data area. A "bootstrap" loader is programmatically accessible 
whenever the BIOS portion is not overlayed; thus, the user program need only 
branch to the bootstrap loader at the end of execution, and the complete CP/M 
monitor is reloaded from disk. 

It should be reiterated that the CP/M operating system is partitioned 
into distinct modules, including the BIOS portion vAiich defines the hardware 
environment in viiich CP/M is executing. Thus, the standard system can be 
easily modified to any non-standard environment by changing the peripheral 
drivers to handle the custom system. 



2. FUNCTiaiAL INSCRIPTION OF CP/M. 

The user interacts with CP/M primarily through the CCP, viiich reads and 
interprets commands entered through the console. In general, the CCP 
addresses one of several disks v*iich are online (the standard system addresses 
up to four different disk drives). These disk drives are labelled A, B, C, 
and D. A disk is "logged in" if the CCP is currently addressing the disk. In 
order to clearly indicate v*iich disk is the currently logged disk, the CCP 
always prompts the operator with the disk name followed by the symbol ">" 
indicating that the CCP is ready for another command. Upon initial start up, 
the CP/M system is brought in from disk A, and the CCP displays the message 

xxK CP/M VER m.m 

where xx is the memory size (in kilobytes) v*iich this CP/M system manages, and 
m.m is the CP/M version number. All CP/M systems are initially set to operate 
in a 16K. memory space, but can be easily reconfigured to fit any memory size 
on the host system (see the MDVCPM transient canmand) . Followirg system 
signon, CP/M automatically logs in disk A, prompts the user with the symbol 
"A>" (indicating that CP/M is currently addressing disk "A") , and waits for a 
command. The commands are implemented at tw^o levels: built-in commands and 
transient commands. 

2.1. GENERAL COMMAND STRUCTURE. 

Built-in commands are a part of the CCP program itself, v*iile transient 
canmands are loaded into the TPA fran disk and executed. The built-in 
commands are 

ERA Erase specified files. 

DIR List file names in the directory. 

REN Rename the specified file. 

SAVE Save memory contents in a file. 

TYPE Type the contents of a file on the logged disk. 

Nearly all of the commands reference a particular file or group of files. The 
form of a file reference is specified below. 

2.2. FILE REFERENCES. 

A file reference identifies a particular file or group of files on a 
particular disk attached to CP/M. These file references can be either 
"unambiguous" (ufn) or "ambiguous" (afn) . An unambiguous file reference 
uniquely identifies a single file, v*iile an ambiguous file reference may be 




satisfied by a number of different files. 

File references consist of two parts: the primary name and the secondary 
name. Although the secondary name is optional , it usually is generic; that 
is, the secondary name "ASM/' for sample, is used to denote that the file is 
an assembly language source file, v*iile the primary name distinguishes each 
particular source file. The tavo names are separated by a "." as shown below: 

PPPPPPPP.sss 

v*iere pppppppp represents the primary name of eight characters or less, and 
sss is the secondary name of no more than three diaracters. As mentioned 
above, the name 

PPPPPPPP 

is also allowed and is equivalent to a secondary name consisting of three 
blanks. The characters used in specifying an unambiguous file reference 
cannot contain any of the special characters 

v*iile all alphanumerics and remaining special characters are allowed. 

An ambiguous file reference is used for directory search and pattern 
matching. The form of an ambiguous file reference is similar to an 
unambiguous reference, except the symbol "?" may be interspersed throughout 
the primary and secondary names. In various commands throughout CP/M, the "?" 
symbol matches any character of a file name in the "?" position. Thus, the 
ambiguous reference 

X?Z.C?M 

is satisfied by the unambiguous file names 

XYZ.GOM 
and 

X3Z.CAM 

Note that the ambiguous reference 

is equivalent to the ambiguous file reference 

v^ile 



and 



PPPPPPPP.* 
*.sss 
are abbreviations for 

PPPPPPPP.??? 
and 

????????. sss 

respectively. As an example^ 

DIR *.* 

is interpreted by the CCP as a command to list the names of all disk files in 
the directory, v*iile 

DIR X.Y 

searches only for a file by the name X.Y Similarly, the ccmmand 

DIR X?Y.C?M 

causes a search for all (unambiguous) file names on the disk viiich satisfy 
this ambiguous reference. 

The following file names are valid unambiguous file references: 

X XYZ GAMMA 

X.Y XYZ. COM GAMMA.l 



As an added convenience, the programmer can generally specify the disk 
drive name along with the file name. In this case, the drive name is given as 
a letter A through Z followed by a colon (:). The specified drive is then 
"logged in" before the file operation occurs. Thus, the following are valid 
file names with disk name prefixes: 



A:X.Y 



B:XYZ 



C:GAMMA 



Z:XYZ.CDM 



B:X.A?M 



C:*.ASM 



It should also be noted that all alphabetic lower case letters in file 
and drive names are always translated to upper case v*ien they are processed by 
the CCP. 



3. SWITCHING DISKS. 



The operator can switch the currently logged disk by typing the disk 
drive name (A, B, C, or D) followed by a colon (:) v*ien the CCP is waiting for 
console irput. Thus, the sequence of prompts and commands shown below might 
occur after the CP/M system is loaded from disk A: 



16K CP/M VER 1.4 

A>DIR 

SAMPLE ASM 

SAMPLE PRN 

A>B: 

B>DIR *.AaM 

DUMP ASM 

FILES A^l 

B>A: 



List all files on disk A. 



Switch to disk B. 

List all "ASM" files on B. 



Switch back to A. 



4. THE RDRM OF BUILT>-IN ODMMANDS. 

The file and device reference forms described above can now be used to 
fully specify the structure of the built-in commands. In the description 
below ^ assume the following abbreviations: 

u&i - unambiguous file reference 

a&i - ambiguous file reference 

cr - carriage return 

Further, recall that the CCP always translates lower case characters to upper 
case characters internally. Thus, lower case alphabetics are treated as if 
they are upper case in command names and file references. 

4.1 ERA afn cr 

The ERA (erase) command removes files from the currently logged-in disk 
(i.e., the disk name currently prompted by CP/M preceding the ">") . The files 
which are erased are those vhich satisfy the ambiguous file reference afn. 
The following examples illustrate the use of ERA: 

ERA X.Y The file named X.Y on the currently logged disk 

is removed from the disk directory, and the space 
is returned. 

ERA X.* All files with primary name X are ranoved from 
the current disk. 

ERA *.ASM All files with secondary name ASM are renroved 
frcm the current disk. 

ERA X?Y.C?M All files on the current disk v*iich satisfy the 
ambiguous reference X?Y.C?M are deleted. 

ERA *.* Erase all files on the current disk (in this case 
the CCP prompts the console with the message 

"ALL FILES (Y/N)?" 
viiich requires a Y response before files are 
actually removed) . 

ERA B:*.PRN All files on drive B v*iich satisfy the ambiguous 
reference ????????. PRN are deleted, independently 
of the currently logged disk. 




4.2. DIR afn cr 

The DIR (directory) command causes the names of all files vhich satisfy 
the ambiguous file name afn to be listed at the console device. As a special 
case, the conmand 

DIR 

lists the files on the currently logged disk (the conmand "DIR" is equivalent 
to the command "DIR *.*"). Valid DIR commands are shown below. 

DIR X.Y 

DIR X?Z.C?M 

DIR ??.Y 

Similar to other CCP conmiands, the afn can be preceded by a drive name. 
The followirri DIR commands cause the selected drive to be addressed before the 
directory search takes place. 

DIR B: 

DIR B:X.Y 

DIR B:*.A?M 

If no files can be found on the selected diskette v*iich satisfy the 
directory request, then the message "NOT FDUND" is typed at the console. 



4.3. REN ufnl=ufn2 cr 

The REN (rename) command allows the user to change the names of files on 
disk. The file satisfying ufn2 is changed to ufnl. The currently logged disk 
is assumed to contain the file to rename (ufnl) . The CCP also allows the user 
to type a left-directed arrow instead of the equal sign, if the user's console 
supports this graphic character. Examples of the REN command are 



REN X.Y=O.R 

REN XYZ.OOM=XYZ.XXX 



The file Q.R is changed to X.Y. 

The file XYZ.XXX is changed to XYZ.OOM. 



The operator can precede either ufnl or ufii2 (or both) by an optional 
drive address. Given that ufnl is preceded by a drive name, then ufn2 is 
assumed to exist on the same drive as ufiil. Similarly, if ufn2 is preceded by 
a drive name, then u&il is assumed to reside on that drive as well. If both 
ufnl and ufn2 are preceded by drive names, then the same drive must be 



specified in both cases. The following REN commands illustrate this format. 

REN AiX.Aavi = Y.ASM The file Y.ASM is changed to X.ASM on 

drive A. 

REN B:ZAP.BAS=ZOT.BAS The file ZOT.BAS is changed to ZAP.BAS 

on drive B. 

REN BrA.Aayi = B:A.BAK The file A.BAK is renamed to A. ASM on 

drive B. 

If the file ufiil is already present^ the REN command will respond with 
the error "FILE EXISTS" and not perform the change. If ufn2 does not exist on 
the specified diskette , then the message "NOT POUND" is printed at the 
console. 



4.4. SAVE n ufn cr 

The SAVE command places n pages (256-bYte blocks) onto disk from the TPA 
and names this file ufn. In the CP/M distribution system^ the TPA starts at 
100H (hexadecimal) , vhich is the second page of memory. Thus, if the user's 
program occupies the area from 100H through 2FFH, the SAVE command must 
specify 2 pages of memory. The machine code file can be subsequently loaded 
and executed. Examples are: 

SAVE 3 X.CDM Copies 100H through 3FFH to X.OOM. 

SAVE 40 Copies 100H through 28FFH to Q (note 

that 28 is the page count in 28FFH, 
and that 28H = 2*16+8 = 40 decimal) . 

SAVE 4 X.Y Copies 100H through 4FFH to X.Y. 

The SAVE command can also specify a disk drive in the afh portion of the 
command, as shown below. 

SAVE 10 BiZOT.OOM Copies 10 pages (100H through 0AFFH) to 

the file ZOT.OOM on drive B. 




4.5. TYPE ufn cr 

The TYPE command displays the contents of the ASCII source file ufn on 
the currently logged disk at the console device. Valid TYPE conmands are 

TYPE X.Y 



TYPE X^PIM 

TYPE XXX 

The TYPE command expands tabs (clt-I characters) , assumming tab positions 
are set at every eighth column. The ufn can also reference a drive name as 
shown below. 

TYPE BiX.PRN The file X.PRN from drive B is displayed. 
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5. 



LINE EDITING MD OUTPUT CONTROL. 

The CCP allows certain line editing functions v*iile typing command lines, 
rubout 



ctl-U 
ctl-X 
ctl-R 

ctl-E 



Delete and echo the last character typed at the 
console. 

Delete the entire line typed at the console. 

(Same as ctl-U) 

Retype current command line: types a "clean line" fol- 
lowing character deletion with rubouts. 

Physical end of line: carriage is returned, but line 
is not sent until the carriage return key is depressed. 



ctl-C CP/M system reboot (warm start) 

ctl-Z End input from the console (used in PIP and ED) . 

The control functions ctl-P and ctl-S affect console output as shown below. 

ctl-P Copy all subsequent console output to the currently 

assigned list device (see the STAT command). Output 
is sent to both the list device and the console device 
until the next ctl-P is typed. 



ctl-S 



Stop the console output temporarily. Program execution 
and output continue v*ien the next character is typed 
at the console (e.g., another ctl-S). This feature is 
used to stop output on high speed consoles, such as 
CRT's, in order to view a segment of output before con- 
tinuing. 



Note that the ctl-key sequences shown above are obtained by depressing the 

control and letter keys sijTtultaneously. Further, CCP command lines can 

generally be up to 255 characters in length; they are not acted upon until the 
carriage return key is typed. 
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6. TRANSIENT COMMANDS. 

Transient commands are loaded from the currently logged disk and executed 
in the TPA. The transient commands defined for execution under the CCP are 
shown below. Additional functions can easily be defined by the user (see the 
LOAD command definition) . 

STAT List the number of bytes of storage remaining on the 

currently logged disk, provide statistical information 
about particular files, and display or alter device 
assignment. 

ASM Load the CP/M assembler and assemble the specified 
program fron disk. 

LOAD Load the file in Intel "hex" machine code format and 

produce a file in machine executable form which can be 
loaded into the TPA (this loaded program becomes a 
new command under the CCP) . 

DDT Load the CP/M debugger into TPA and start execution. 

PIP Load the Peripheral Interchange Program for subsequent 
disk file and peripheral transfer operations. 

ED Load and execute the CP/M text editor program. 

SYSGEN Create a new CP/M system diskette. 

SUBMIT Submit a file of commands for batch processing. 

DUMP Dump the contents of a file in hex. 

MOVCPM Regenerate the CP/M system for a particular memory 
size. 



Transient commands are specified in the same manner as built-in canmands, and 
additional commands can be easily defined by the user. As an added 
convenience, the transient command can be preceded by a drive name, which 
causes the transient to be loaded from the specified drive into the TPA for 
execution. Thus, the command 

B:STAT 

causes CP/M to temporarily "log in" drive B for the source of the STAT 
transient, and then return to the original logged disk for subsequent 
processing. 
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The basic transient commands are listed in detail below. 

6.1. STAT cr 

The STAT command provides general statistical information about file 
storage and device assignment. It is initiated by typing one of the following 
forms: 

STAT cr 

STAT "command line" cr 

Special forms of the "command line" allow the current device assignment to be 
examined and altered as well. The various command lines viiich can be 
specified are shown below, with an explanation of each form shown to the 
right. 



STAT cr 



STAT x: cr 



STAT afn cr 



If the user types an empty caranand line, the STAT 
transient calculates the storage renaining on all 
active drives, and prints a message 



or 



x: R/W, SPACE: nnnK 
x: R/0, SPACE: nnnK 



for each active drive x, v*iere R/W indicates the 
drive may be read or written, and R/0 indicates 
the drive is read only (a drive becomes R/0 by 
explicitly setting it to read only, as shown 
below, or by inadvertantly changing diskettes 
without performing a warm start) . The space 
renaining on the diskette in drive x is given 
in kilobytes by nnn. 

If a drive name is given, then the drive is 
selected before the storage is canputed. Thus, 
the command "STAT B:" could be issued while 
logged into drive A, resulting in the message 

BYTES REMAINING CM B: nnnK 

The command line can also specify a set of files 
to be scanned by STAT. The files which satisfy 
afn are listed in alphabetical order, with stor- 
^e requirements for each file under the heading 



Append 
A 



RECS BYTS EX D: FILENAME. TYP 
rrrr bbbK ee d:pppppppp.sss 

vAiere rrrr is the number of 128-byte records 
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allocated to the file^ bbb is the number of kilo- 
bytes allocated to the file (bbb=rrrr*128/1024) , 
ee is the number of 16K extensions (ee=bbb/16) , 
d is the drive name containing the file (A. ..Z)^ 
PPPPPPPP is the (up to) eight-character primary 
file name, and sss is the (up to) three-character 
secondary name. After listing the individual 
files, the storage usage is summarized. 

STAT x:afn cr As a convenience, the drive name can be given 

ahead of the afn. In this case, the specified 
drive is first selected, and the form "STAT afn" 
is executed. 

STAT x:=R/0 cr This form sets the drive given by x to read-only, 

v*iich remains in effect until the next warm or 
cold start takes place. When a disk is read-only, 
the message 

BDOS ERR ON x: READ ONLY 

will appear if there is an attempt to write to 
the read-only disk x. CP/M waits until a key 
is depressed before performing an automatic warm 
start (at which time the disk becomes R/W) . 

The STAT command also allows control over the physical to logical device 
assignment (see the lOBYTE function described in the manuals "CP/M Interface 
Guide" and "CP/M System Alteration Guide"). In general, there are four 
logical peripheral devices vAiich are, at any particular instant, each assigned 
to one of several physical peripheral devices. The four logical devices are 
named: 

CON: The system console device (used by CCP 

for communication with the operator) 

RDR: The paper tape reader device 

PUN: The paper tape punch device 

LST: The output list device 

The actual devices attached to any particular conputer system are driven 
by subroutines in the BIOS portion of CP/M. Thus, the logical RDR: device, 
for example, could actually be a high speed reader. Teletype reader, or 
cassette tape. In order to allow some flexibility in device naming and 
assignment, several physical devices are defined, as shown below: 
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TIY: Teletype device (slow speed console) 

CRT: Cathode ray tube device (high speed console) 

BAT: Batch processing (console is current RDR: , 

output goes to current LST: device) 

UCl: User-defined console 

PTR: Paper tape reader (high speed reader) 

URl: User-defined reader #1 

UR2: User-defined reader #2 

PTP: Paper tape punch (high speed punch) 

UPl: User-defined punch #1 

UP2: User-defined punch #2 

LPT: Line printer 

ULl: User-defined list device #1 

It must be emphasized that the physical device names may or may not 
actually correspond to devices vAiich the names imply. That is, the PTP: 
device may be implemented as a cassette write operation, if the user wishes. 
The exact correspondence and driving subroutine is defined in the BIOS portion 
of CP/M. In the standard distribution version of CP/M, these devices 
correspond to their names on the MDS 800 development system. 

The possible logical to physical device assignments can be displayed by 
typing 

STAT VAL: cr 

The STAT prints the possible values v^ich can be taken on for each logical 
device: 

CON. = TTf: CRT: BAT: UCl 

RDR: = TTY: PTR: URl: UR2 

PUN: = TTY: PTP: UPl: UP2 

LST: = TTY: CRT: LPT: ULl 

In each case, the logical device shown to the left can take any of the four 
physical assignments shown to the right on each line. The current logical to 
physical mapping is displayed by typing the command 

STAT DEV: cr 
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which prcx3uces a listing of each logical device to the left^ and the current 
corresponding pt^sical device to the right. For example r the list might 
appear as follows: 

CDN: = CRT: 
RDR: = URl: 
PUN: = FTP: 
LST: = TTY: 

The current logical to physical device assignment can be changed by typing a 
STAT command of the form 

STAT Idl = pdl, ld2 = pd2 , ..• , Idn = pdn cr 

where Idl through Idn are logical device names ^ and pdl through pdn are 
compatible physical device names (i.e.r Idi and pdi appear on the same line in 
the "VAL:" command shown above). The following are valid STAT commands v*iich 
change the current logical to physical device assignments: 

STAT a)N:=CRr: cr 

STAT PUN: = TTY: ,LST:=LPT: ^ RDR:=TTy: cr 



6.2. ASM ufri cr 

The Aayi command loads and executes the CP/M 8080 assembler. The ufn 
specifies a source file containing assembly language statements vyAiere the 
secondary name is assumed to be ASM ^ and thus is not specified. The following 
ASM commands are valid: 

ASM X 

ASM GAMMA 

The two-pass assembler is autanatically executed. If assembly errors occur 
during the second pass, the errors are printed at the console. 

The assembler produces a file 

x.PRN 

v*iere x is the primary name specified in the ASM connmand. The PRN file 
contains a listing of the source program (with imbedded tab characters if 
present in the source program) , along with .the machine code generated for each 
statement and diagnostic error messages, if any. The PRN file can be listed 
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at the console using the TYPE command, or sent to a peripheral device using 
PIP (see the PIP command structure below) • Note also that the PRN file 
contains the original source program, augmented by miscellaneous assembly 
information in the leftmost 16 columns (program addresses and hexadecimal 
machine code, for example). Thus, the PRN file can serve as a backup for the 
original source file: if the source file is accidently removed or destroyed, 
the PRN file can be edited (see the ED operator's guide) by rorovir^ the 
leftmost 16 characters of each line (this can be done by issuing a single 
editor "macro" command) . The resulting file is identical to the original 
source file and can be renamed (REN) from PRN to ASM for subsequent editing 
and assembly. The file 

XoHEX 

is also produced viiich contains 8080 machine language in Intel "hex" format 
suitable for subsequent loading arxS execution (see the LOAD coranand) . For 
complete details of CP/M's assembly language program, see the "CP/M Assembler 
Language (ASM) User's Guide." 

Similar to other transient commands, the source file for assembly can be 
taken from an a^-ternate disk by prefixing the assembly language file name by a 
disk drive name. Thus, the conmand 

ASM BrALEHA cr 

loads the assembler frcxn the currently logged drive and operates upon the 
source program ALfflA.ASM on drive B. The HEX and PRN files are also placed on 
drive B in this case. 



6.3a LOAD ufn cr 

The LOAD conmand reads the file ufn, v*iich is assumed to contain "hex" 
format machine code, and produces a memory image file which can be 
subsequently executed. The file name ufn is assumed to be of the form 

x.HEX 

and thus only the name x need be specified in the command. The LOAD connmand 
creates a file named 

x.OOM 

viiich marks it as containing machine executable code. The file is actually 
loaded into memory and executed vAien the user types the file name x 
immediately after the prompting character ">" printed by the CCP. 

In general, the CCP reads the name x following the pronpting character 
and looks for a built-in function name. If no function name is found, the CCP 
searches the system disk directory for a file by the name 
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x.CDM 

If found, the machine code is loaded into the TPA, and the program executes. 
Thus, the user need only LOAD a hex file once; it can be subsequently 
executed any number of times by simply typing the primary name. In this way, 
the user can "invent" new commands in the CCP. (Initialized disks contain the 
transient commands as OOM files, v^ich can be deleted at the user's option.) 
The operation can take place on an alternate drive if the file name is 
prefixed by a drive name. Thus, 

LOAD B:BETA 

brings the LOAD program into the TPA from the currently logged disk and 
operates upon drive B after execution begins. 

It must be noted that the BETA. HEX file must contain valid Intel format 
hexadecimal machine code records (as produced by the ASM program, for example) 
which begin at 100H, the beginning of the TPA. Further, the addresses in the 
hex records must be in ascending order; gaps in unfilled memory regions are 
filled with zeroes by the LOAD conmand as the hex records are read. Thus, 
LOAD must be used only for creating CP/M standard "COM" files v^iich operate in 
the TPA. Programs which occupy regions of memory other than the TPA can be 
loaded under DDI'. 



6.4. PIP cr 

PIP is the CP/M Peripheral Interchange Program which implements the basic 
media conversion operations necessary to load, print, punch, copy, and combine 
disk files. The PIP program is initiated by typing one of the following forms 

(1) PIP cr 

(2) PIP "command line" cr 

In both cases, PIP is loaded into the TPA and executed. In case (1) , PIP 
reads command lines directly fran the console, prompted with the "*" 
character, until an empty command line is typed (i.e., a single carriage 
return is issued by the operator) . Each successive command line causes some 
media conversion to take place according to the rules shown below. Form (2) 
of the PIP command is equivalent to the first, except that the single canmand 
line given with the PIP command is automatically executed, and PIP terminates 
immediately with no further prompting of the console for input canmand lines. 
The form of each command line is 



destination = source#l, source#2, ..• , source#n cr 
where "destination" is the file or peripheral device to receive the data, and 
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"*source#l, ,.«, source#n" represents a series of one or more files or devices 
which are copied from left to right to the destination. 

When multiple files are given in the conmand line (i.e^ n > 1) , the 
individual files are assumed to contain ASCII characters, with an assumed CP/M 
end-of-file character (ctl-Z) at the end of each file (see the parameter to 
override this assumption) . The equal symbol (=) can be replaced by a 
left-oriented arrow, if your console supports this ASCII character, to improve 
readability. Lower case ASCII alphabetics are internally translated to upper 
case to be consistent with CP/M file and device name conventions. Finally, 
the total command line length cannot exceed 255 characters (ctl-E can be used 
to force a physical carriage return for lines vdiich exceed the console width) , 

The destination and source elements can be unambiguous references to CP/M 
source files, with or without a preceding disk drive name. That is, any file 
can be referenced with a preceding drive name (A:, B:, C:, or D:) which 
defines the particular drive where the file may be obtained or stored. When 
the drive name is not included, the currently logged disk is assumed. 
Further, the destination file can also appear as one or more of the source 
files, in v*iich case the source file is not altered until the entire 
concatenation is complete. If the destination file already exists, it is 
removed if the command line is properly formed (it is not removed if an error 
condition arises) . The following command lines (with explanations to the 
right) are valid as input to PIP: 



X = Y cr 



Copy to file X fron file Y, 
where X and Y are unambiguous 
file names; Y remains unchanged. 



X = Y,Z cr 



Concatenate files Y and Z and 
copy to file X, with Y and Z 
unchanged. 



XoASM=Y.ASM,Z.ASM,FIN.ASM cr 



NEW.ZOT = B:OLD.ZAP cr 



Create the file X.ASM fron the 
concatenation of the Y, Z, and 
FIN files with type ASM. 

Move a copy of OLD. ZAP from drive 
B to the currently logged disk; 
name the file NEW.ZOT. 



B:A.U = B:B.V,A:C.W,D.X cr 



Concatenate file B.V fron drive B 
v/ith C.W from drive A and D.X. 
frcxn the logged disk; create 
the file A.U on drive B. 



For more convenient use, PIP allows abbreviated commands for transferring 
files between disk drives. The abbreviated forms are 
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PIP x:=afn cr 

PIP x:=y:afn cr 

PIP ufn = y: cr 

PIP x:ufn = y: cr 

The first form copies all files from the currently loqged disk vAiich satisfy 
the afri to the same file names on drive x (x = A...Z). The second form is 
equivalent to the firsts v*iere the source for the copy is drive y (y = A... 
Z) . The third form is equivalent to the carunand "PIP ufn=y:ufn cr" which 
copies the file given by u&i fron drive y to the file ufn on drive x. The 
fourth form is equivalent to the thirds v*iere the source disk is explicitly 
given by y. 

Note that the source and destination disks must be different in all of 
these cases. If an afn is specified, PIP lists each ufn which satisfies the 
afn as it is being copied. If a file exists by the same name as the 
destination file, it is removed upon successful completion of the copy, and 
replaced by the copied file. 

The following PIP commands give examples of valid disk-to-disk copy 
operations: 

B:=*.aoiyi cr Copy all files which have the 

secondary name "OOM" to drive B 
fron the current drive. 

A:=B:ZAP.* cr Copy all files v*iich have the 

primary name "ZAP" to drive A 
from drive B. 

ZAP.ASiyi=B: cr Equivalent to ZAP.ASiyi=B:ZAP.ASM 

B:ZOT.aOM=A: cr Equivalent to B:Z0T.00M=A:ZOT.00M 

B:=GAMMA.BAS cr Same as B: GAMMA. BAS=GAMMA.BAS 

B:=A:GAMMA.BAS cr Same as B: GAMMA. BAS=A: GAMMA. BAS 

PIP also allows reference to physical and logical devices which are 
attached to the CP/M system. The device names are the same as given under the 
STAT command, along with a number of specially named devices. The logical 
devices given in the STAT command are 

CON: (console) , RDR: (reader) , PUN: (punch) , and LST: (list) 

while the physical devices are 
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TTY: (console, reader, punch, or list) 

CRT: (console, or list) , UCl: (console) 

PTR: (reader) , URl: (reader) , UR2: (reader) 

PTP: (punch), UPl: (punch), UP2: (punch) 

LPT: (list), UU: (list) 

(Note that the "BAT:" physical device is not included, since this assignment 
is used only to indicate that the RDR: and LST: devices are to be used for 
console iiput/output.) 

The FDR, LST, PUN, and CON devices are all defined within the BIOS 
portion of CP/M, and thus are easily altered for any particular I/O system. 
(The current physical device mapping is defined by lOBYTE; see the "CP/M 
Interface Guide" for a discussion of this function) . The destination device 
must be capable of receiving data (i.e., data cannot be sent to the punch), 
and the source devices must be capable of generating data (i.e., the LST: 
device cannot be read) . 

The additional device names viiich can be used in PIP commands are 

NUL: Send 40 "nulls" (ASCII 0's) to the device 

(this can be issued at the end of punched output). 

EOF: Send a CP/M end-of-file (ASCII ctl-Z) to the 
destination device (sent automatically at the 
end of all ASCII data transfers through PIP) . 

INP: Special PIP input source viiich can be "patched" 
into the PIP program itself: PIP gets the input 
data character-by-character by CZ^Ling location 
103H, with data returned in location 109H (parity 
bit must be zero) . 

OUT: Special PIP output destination which can be 

patched into the PIP program: PIP CALLs location 
106H with data in register C for each character 
to transmit. Note that locations 109H through 
IFFH of the PIP memory image are not used and 
can be replaced by special purpose drivers using 
DDT (see the DDT operator's manual). 

PRN: Same as LST:, except that tabs are expanded at 
every eighth character position, lines are 
numbered, and page ejects are inserted every 60 
lines, with an initial eject (same as [tSnp]). 

File and device names can be interspersed in the PIP canmands. In each 
case, the specific device is read until end-of-file (ctl-Z for ASCII files, 
and a real end of file for non-ASCII disk files) . Data fran each device or 
file is concatenated from left to right until the last data source has been 
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read. The destination device or file is written using the data fron the 
source files^ and an end-of-file character (ctl-Z) is appended to the result 
for ASCII files. Note if the destination is a disk file^ then a temporary 
file is created ($$$ secondary name) v*iich is chanqed to the actual file name 
only upon successful completion of the copy. Files with the extension "CDM" 
are always assumed to be non-ASCII. 

The copy operation can be aborted at any time by depressing any key on 
the keyboard (a rubout suffices) . PIP will respond with the message "ABORTED" 
to indicate that the operation was not completed. Note that if any operation 
is aborted, or if an error occurs during processing, PIP renoves any pending 
commands v^iich were set up vAiile using the SUBMIT command. 

It should also be noted that PIP performs a special function if the 
destination is a disk file with type "HEX" (an Intel hex formatted machine 
code file), and the source is an external peripheral device, such as a paper 
tape reader. In this case, the PIP program checks to ensure that the source 
file contains a properly formed hex file, with legal hexadecimal values and 
checksum records. When an invalid input record is found, PIP reports an error 
message at the console and waits for corrective action. It is usually 
sufficient to open the reader and rerun a section of the tape (pull the tape 
back about 20 inches). When the tape is ready for the re-read, type a single 
carriage return at the console, and PIP will attempt another read. If the 
tape position cannot be properly read, simply continue the read (by typing a 
return following the error message) , and enter the record manually with the ED 
program after the disk file is constructed. For convenience, PIP allows the 
end-of-file to be entered from the console if the source file is a RDR: 
device. In this case, the PIP program reads the device and monitors the 
keyboard. If ctl-Z is typed at the keyboard, then the read operation is 
terminated normally. 

Valid PIP connmands are shown below. 



PIP 1ST I = X.PRN cr 



PIP cr 



*aON:=X.ASM,Y.ASM,Z.ASM cr 



*X.HEX=CON: ,Y.HEX,PrR: cr 



^cr 



Copy X.PRN to the LST device and 
terminate the PIP program. 

Start PIP for a sequence of 
commands (PIP prompts with "*"). 

Concatenate three ASM files and 
copy to the CON device. 

Create a HEX file by reading the 
CON (until a ctl-Z is typed) , fol- 
lowed by data from Y.HEX, followed 
by data fran PTR until a ctl-Z is 
encountered. 

Single carriage return stops PIP. 
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PIP PUN:=NUL:,X.ASM,EOF:,NUL: cr Send 40 nulls to the punch devices- 
then copy the X.ASM file to the 
punch, followed by an end-of-file 
(ctl-Z) and 40 more null charac- 
ters. 

The user can also specify one or wore PIP parameters, enclosed in left 
and right square brackets, separated by zero or more blanks. Each parameter 
affects the copy operation, and the enclosed list of parameters must 
immediately follow the affected file or device. Generally, each parameter can 
be followed by an optional decimal integer value (the S and parameters are 
exceptions) . The valid PIP parameters are listed below. 

B Block mode transfer: data is buffered by PIP until an ASCII 
x-off character (ctl-S) is received frona the source device. 
This allows transfer of data to a disk file from a continuous 
reading device, such as a cassette reader. Upon receipt of 
the x-off, PIP clears the disk buffers and returns for more 
input data. The amount of data vdiich can be buffered is de- 
pendent upon the memory size of the host system (PIP will 
issue an error message if the buffers overflow) . 

Dn Delete characters Which extend past column n in the transfer 
of data to the destination from the character source. This 
parameter is used most often to truncate long lines v^ich are 
sent to a (narrow) printer or console device. 

E Echo all transfer operations to the console as they are being 
performed. 

F Filter form feeds from the file. All imbedded form feeds are 
ranoved. The P parameter can be used simultaneously to 
insert new form feeds. 

H Hex data transfer: all data is checked for proper Intel hex 
file format. Non-essential characters between hex records 
are removed during the copy operation. The console will be 
prompted for corrective action in case errors occur. 

I Ignore ":00" records in the transfer of Intel hex format 
file (the I parameter automatically sets the H parameter) . 

L Translate upper case alphabet ics to lower case. 

N Add line numbers to each line transferred to the destination 
starting at one, and incrementing by 1. Leading zeroes are 
suppressed, and the number is followed by a colon. If N2 
is specified, then leading zeroes are included, and a tab is 
inserted following the number. The tab is expanded if T is 
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set. 

Object file (non-ASCII) transfer: the normal CP/M end of 
file is ignored. 

Pn Include page ejects at every n lines (with an initial page 
eject). If n = 1 or is excluded altogether, page ejects 
occur every 60 lines. If the F parameter is used, form feed 
suppression takes place before the new page ejects are 
inserted. 

Qs^z Quit copying from the source device or file viien the 
string s (terminated by ctl-Z) is encountered. 

Ss'^z Start copying from the source device v^ien the string s is 
encountered (terminated by ctl-Z). The S and parameters 
can be used to "abstract" a particular section of a file 
(such as a subroutine) . The start and quit strings are al- 
ways included in the copy operation. 

NOTE - the strings following the s and g parameters are 
translated to upper case by the CCP if form (2) of the 
PIP command is used. Form (1) of the PIP invocation, how- 
ever, does not perform the automatic upper case translation. 

(1) PIP cr 

(2) PIP "command line" cr 

Tn Expand tabs (ctl-I characters) to every nth column during the 
transfer of characters to the destination from the source. 

U Translate lower case alphabetics to upper case during the 
the copy operation. 

V Verify that data has been copied correctly by rereading 

after the write operation (the destination must be a disk 
file). 

Z Zero the parity bit on input for each ASCII character. 

The following are valid PIP ccmmands which specify parameters in the file 
transfer: 

PIP X.ASM=B: [v] cr Copy X.ASM from drive B to the current drive 

and verify that the data was properly copied. 

PIP LPr:=X.ASM[nt8u] cr Copy X.ASM to the LPT: device; number each 

line, expand tabs to every eighth column, and 
translate lower case alphabetics to upper 
case. 
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PIP PUN:=X.HEX[i] ,Y.ZOT[h] cr First copy X.HEX to the PUN: device and 

ignore the trailing ":00'* record in X.HEX; 
then continue the transfer of data by reading 
Y.ZOT^ v*iich contains hex records, including 
any ":00" records v*iich it contains, 

PIP X.LIB = Y.ASM [ sSUBKLr^z qJMP L3'^z ] cr Copy fran the file Y.ASM 

into the file X.LIB. Start the copy v*ien the 
string "SUBRl:" has been found, and quit copy- 
irg after the string "JMP L3" is encountered. 



PIP FRN:=X.ASM[p50] Send X.ASM to the LST: device, with line num- 

bers, tabs expanded to every eighth column, 
and page ejects at every 50th line. Note that 
nt8p60 is the assumed parameter list for a PRN 
file; p50 overrides the default value. 



6.5. ED ufn cr 

The ED program is the CP/M system context editor, v*iich allows creation 
and alteration of ASQI files in the CP/M environment. Complete details of 
operation are given the ED user's manual, "ED: a Context Editor for the CP/M 
Disk System." In general, ED allows the operator to create and operate upon 
source files vghich are organized as a sequence of ASCII characters, separated 
by end-of-line characters (a carriage-return line-feed sequence) . There is no 
practical restriction on line length (no single line can exceed the size of 
the working memory) , v*iich is instead defined by the number of characters 
typed between cr's. The ED program has a number of commands for character 
string searching, replacement, and insertion, vdiich are useful in the creation 
and correction of programs or text files under CP/M. Although the CP/M has a 
limited memory work space area (approximately 5000 characters in a 16K CP/M 
system) , the file size viiich can be edited is not limited, since data is 
easily "paged" through this work area. 

Upon initiation, ED creates the specified source file, if it does not 
exist, and opens the file for access. The programmer then "appends" data from 
the source file into the work area, if the source file already exists (see the 
A command), for editing. The appended data can then be displayed, altered, 
and written from the work area back to the disk (see the W coranand) . 
Particular points in the program can be automatically paged and located by 
context (see the N connmand) , allowing easy access to particular portions of a 
large file. 

Given that the operator has typed 

ED X.ASM cr 
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the ED program creates an intermediate work file with the name 

X.$$$ 

to hold the edited data during the ED run. Upon completion of ED^ the X.ASM 
file (original file) is renamed to X.BAK, and the edited work file is renamed 
to X.ASM. Thus, the X.BAK file contains the original (unedited) file, and the 
X.ASM file contains the newly edited file. The operator can always return to 
the previous version of a file by removing the most recent version, and 
renaming the previous version. Suppose, for example, that the current X.ASM 
file was improperly edited; the sequence of CCP command shown below would 
reclaim the backup file. 

DIR X.* Check to see that BAK file 

is available. 

ERA. X.ASM Erase most recent version. 

REN X.ASM=X.BAK Rename the BAK file to ASM. 



Note that the operator can abort the edit at any point (reboot, power failure, 
ctl-C, or Q command) without destroying the original file. In this case, the 
BAK file is not created, and the original file is always intact. 

The ED program also allows the user to "ping-pong" the source and create 
backup files between two disks. The form of the ED command in this case is 

ED ufn d: 

where ufii is the name of a file to edit on the currently logged disk, and d is 
the name of an alternate drive. The ED program reads and processes the source 
file, and writes the new file to drive d, using the name u&i. Upon completion 
of processing, the original file becones the backup file. Thus, if the 
operator is addressing disk A, the following command is valid: 

ED X.ASM B: 

which edits the file X.ASM on drive A, creating the new file X.$$$ on drive 
B. Upon completion of a successful edit, A:X.ASM is renamed to AiX.BAK, and 
B:X.$$$ is renamed to BrX.ASM. For user convenience, the currently logged 
disk becones drive B at the end of the edit. Note that if a file by the name 
BiX.ASM exists before the editing begins, the message 

FILE EXISTS 

is printed at the console as a precaution against accidently destroying a 
source file. In this case, the operator must first ERAse the existing file 
and then restart the edit operation. 
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Similar to other transient conomands, editing can take place on a drive 
different from the currently logged disk by preceding the source file name by 
a drive name. Examples of valid edit requests are shown below 

ED AiX.ASM Edit the file X.ASM on drive A, with 

new file and backup on drive A. 

ED BiX.ASM A: Edit the file X.ASM on drive B to the 

temporary file X.$$$ on drive A. On 
termination of editing^ change X.ASM 
on drive B to X.BAK, and change X.$$$ 
on drive A to X.ASM. 

6.6. SYSGEN cr 

The SYSGEN transient command allows generation of an initialized diskette 
containing the CP/M operating system. The SYSGEN program pronpts the console 
for commands, with interaction as shown below. 

SYSGEN cr Initiate the SYSGEN program. 

SYSGEN VERSION m.m SYSGEN sign-on message. 

SOURCE DRIVE NAME (OR RETURN TO SKIP) 

Respond with the drive name (one 
of the letters A, B, C, or D) of 
the disk containing a CP/M sys- 
tem; usually A. If a copy of 
CP/M already exists in memory, 
due to a MOVCPM command, type a 
cr only. Typing a drive name 
X will cause the response: 

SOURCE ON X THEN TYPE RETURN Place a diskette containing the 

CP/M operating system on drive 
X (x is one of A, B, C, or D) . 
Answer with cr when ready. 

FUNCTION COMPLETE System is copied to memory. 

SYSGEN will then prompt with: 

DESTINATION DRIVE NAME (OR RETURN TO REBOOT) 

If a diskette is being ini- 
tialized, place the new disk 
into a drive and answer with 
the drive name. Otherwise, type 
a cr and the system will reboot 
from drive A. Typing drive name 
X will cause SYSGEN to pronpt 
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with: 

DESTINATION ON X THEN TYPE RETURN Place new diskette into drive 

x; type return v*ien ready. 

FUNCTiasi COMPLETE New diskette is initialized 

in drive x. 

The "DESTINATION" prompt will be repeated until a single carriage return is 
typed at the console ^ so that more than one disk can be initialized. 

Upon completion of a successful system generation, the new diskette 
contains the operating systan, and only the built-in commands are available. 
A factory- fresh IBM-compatible diskette appears to CP/M as a diskette with an 
empty directory; therefore, the operator must copy the appropriate COM files 
from an existing CP/M diskette to the newly constructed diskette using the PIP 
transient. 

The user can copy all files from an existing diskette by typing the PIP 
command 

PIP B: = A: *.*[v] cr 

v*iich copies all files from disk drive A to disk drive B, and verifies that 
each file has been copied correctly. The name of each file is displayed at 
the console as the copy operation proceeds. 

It should be noted that a SYSGEN does not destroy the files v*iich already 
exist on a diskette; it results only in construction of a new operating 
system. Further, if a diskette is being used only on drives B through D, and 
will never be the source of a bootstrap cperation on drive A, the SYSGEN need 
not take place. In fact, a new diskette needs absolutely no initialization to 
be used with CP/M. 



6.7. SUBMIT ufn parm#l ... parm#n cr 

The SUBMIT command allows CP/M commands to be batched together for 
autanatic processing. The ufn given in the SUBMIT command must be the 
filename of a file vdiich exists on the currently logged disk, with an assumed 
file type of "SUB." The SUB file contains CP/M prototype commands, with 
possible parameter siiDstitution. The actual .parameters parm#l ... parm#n are 
substituted into the prototype commands, and, if no errors occur, the file of 
substituted commands are processed seguentially by CP/M. 
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The prototype command file is created using the ED program^ with 
interspersed "$" parameters of the form 



$1 $2 $3 



$n 



corresponding to the number of actual parameters v*iich will be included v*ien 
the file is submitted for execution. VJlien the SUBMIT transient is executed^ 
the actual parameters parm#l .•. parm#n are paired with the formal parameters 
$1 ... $n in the prototype commands. If the number of formal and actual 
parameters does not correspond, then the submit function is aborted with an 
error message at the console. The SUBMIT function creates a file of 
substituted commands with the name 

$$$.SUB 

on the logged disk. When the systen reboots (at the termination of the 
SUBMIT) , this command file is read by the CCP as a source of input, rather 
than the console. If the SUBMIT function is performed on any disk other than 
drive A, the commands are not processed until the disk is inserted into drive 
A and the syston reboots. Further, the user can abort command processing at 
any time by typing a rubout v*ien the command is read and echoed. In this 
case, the $$$.SUB file is removed, and the subsequent commands come from the 
console. Command processing is also aborted if the CCP detects an error in 
any of the commands. Programs which execute under CP/M can abort processing of 
command files v*ien error conditions occur by simply erasing any existing 
$$$.SUB file. 

In order to introduce dollar signs into a SUBMIT file, the user may type 
a "$$" v*iich reduces to a single "$" within the command file. Further, an 
up-arrow symbol "^" may precede an alphabetic character x, v*iich produces a 
single ctl-x character within the file. 

The last command in a SUB file can initiate another SUB file, thus 
allowing chained batch commands. 



Appendix 
A 



commands 



Suppose the file ASMBL.SUB exists on disk and contains the prototype 



and the conranand 



ASM $1 
DIR $1.* 
ERA *.BAK 
PIP $2:=$1.PRN 
ERA $1.PRN 



SUBMIT ASMBL X PRN cr 



is issued by the operator. The SUBMIT program reads the ASMBL.SUB file, 
substituting "X" for all occurrences of $1 and "PRN" for all occurrences of 
$2, resulting in a $$$.SUB file containing the ccxtimands 
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ASM X 

DIR X.* 

ERA *.BAK 

PIP PRN:=X.PRN 

ERA X.PRN 

v*iich are executed in sequence by the CCP, 

The SUBMIT function can access a SUB file v*iich is on an alternate drive 
by preceding the file name by a drive name. Subnitted files are only acted 
upon, however, viien they appear on drive A. Thus/ it is possible to create a 
submitted file on drive B v*iich is executed at a later time v*ien it is 
inserted in drive A. 



6.8. DUMP ufn cr 

The DUMP program types the contents of the disk file (ufn) at the console 
in hexadecimal form. The file contents are listed sixteen bytes at a time, 
with the absolute byte address listed to the left of each line in 
hexadecimal. Long typeouts can be aborted by pushing the rubout key during 
printout. (The source listing of the DUMP program is given in the "CP/M 
Interface Guide" as an example of a program written for the CP/M environment.) 



6.9. MDVCPM cr 

The MOVCPM program allows the user to reconfigure the CP/M system for any 
particular memory size. Two optional parameters may be used to indicate (1) 
the desired size of the new system and (2) the disposition of the new system 
at program termination. If the first parameter is emitted or a "*" is given, 
the MDVCPM program will reconfigure the system to its maximum size, based upon 
the kilobytes of contiguous RAM in the host system (starting aat 0000H) . If 
the second parameter is omitted, the system is executed, but not permanently 
recorded; if *'*" is given, the system is left in memory, ready for a SYSGEN 
operation. The MDVCPM program relocates a memory image of CP/M and places 
this image in memory in preparation for a systap generation operation. The 
command forms are: 

MOVCPM cr Relocate and execute CP/M for manage- 

ment of the current memory configura- 
tion (memory is examined for contigu- 
ous RAM, starting at 100H) . Upon con- 
pletion of the relocation, the new 
system is executed but not permanently 
recorded on the diskette. The system 
which is constructed contains a BIOS 
for the Intel MDS 800. 
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MOVCPM n cr Create a relocated CP/M systeTn for 

nianagement of an n kilobyte system (n 
must be in the range 16 to 64) , and 
execute the system^ as described above. 

MOVCPM * * cr Construct a relocated memory image for 

the current memory configuration, but 
leave the memory image in memory, in 
preparation for a SYSGEN operation. 

MOVCPM n * cr Construct a relocated memory image for 

an n kilobyte memory system, and leave 
the memory image in preparation for a 
SYSGEN operation. 

The command 

MOVCPM * * 

for example, constructs a new version of the CP/M system and leaves it in 
memory, ready for a SYSGEN operation. The message 

READY FOR "SYSGEN" OR 
"SAVE 32 CPMxx.OOM" 

is printed at the console upon completion, vAiere xx is the current memory size 
in kilobytes. The operator can then type 

SYSGEN cr Start the system generation. 

SOURCE DRIVE NAME (OR RETURN TO SKIP) Respond with a cr to skip 

the CP/M read operation since the system 
is already in memory as a result of the 
previous MOVCPM operation. 

DESTINATION DRIVE NAME (OR RETURN T0 REBOOT) 

Respond with B to write new system 
to the diskette in drive B. SYSGEN 
will prompt with: 

DESTINATION ON B, THEN TYPE RETURN 

Ready the fresh diskette on drive 
B and type a return v*ien ready. 

Note that if you respond with "A" rather than "B" above, the system will be 
written to drive A rather than B. SYSGEN will continue to type the pronpt: 

DESTINATIOJ DRIVE NAME (OR RETURN TO REBOOT) 

until the cperator responds with a single carriage return, v^iich stops the 
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SYSGEN program with a systena reboot^ 

The user can then go through the reboot process with the old or new 
diskette. Instead of performing the SYSGEN operation, the user could have 
typed 

SAVE 32 CPMxx.OOM 

at the ccmpletion of the ^DVCPM function, viiich would place the CP/M memory 
image on the currently logged disk in a form which can be "patched." This is 
necessary vAien operating in a non-standard environment v*iere the BIOS must be 
altered for a particular peripheral device configuration, as described in 
the" CP/M System Alteration Guide." 

Valid MOVCPM commands are given below: 

MOVCPM 48 cr Construct a 48K verskon of CP/M and start 

execution. 



MOVCPM 48 * cr 



Construct a 48K version of CP/M in prepara- 
tion for permanent recording; response is 



MOVCPM * * cr 



READY FOR "SYSGEN" OR 
"SAVE 32CPM48.COM" 

Construct a maximum memory version of CP/M 
and start execution. 



It is important to note that the newly created system is serialized with 
the number attached to the original diskette and is subject to the conditions 
of the Digital Research Software Licensing Agreement. 
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7. BDOS ERROR NESSAGES. 

There are three error situations viiich the Basic Disk Operating System 
intercepts durirg file processsing. When one of these conditions is detected ^ 
the BDOS prints the message: 

BDOS ERR CM x: error 

v*iere x is the drive name, and "error" is one of the three error messages: 

BAD SECTOR 
SELECT 
READ ONLY 

The "BAD SECTOR" message indicates that the disk controller electronics 
has detected an error condition in reading or writing the diskette. This 
condition is generally due to a malfunctioning disk controller^ or an 
extremely worn diskette. If you find that your system reports this error more 
than once a month, you should dieck the state of your controller electronics, 
and the condition of your media. You may also encounter this condition in 
reading files generated by a controller produced by a different manufacturer. 
Even though controllers are claimed to be IBM-compatible, one often finds 
small differences in recording formats. The MES-800 controller, for example, 
requires bvo bytes of one's following the data CRC byte, vhich is not required 
in the IBM format. As a result, diskettes generated by the Intel MDS can be 
read by almost all other IB^^-compatible systems, v*iile disk files generated on 
other manufacturer's equipment will produce the "BAD SECTOR" message v*ien read 
by the MDS. In any case, recovery from this condition is acconplished by 
typing a ctl-C to reboot (this is the safest!) , or a return, vhich simply 
ignores the bad sector in the file operation. Note, however, that typing a 
return may destroy your diskette integrity if the c^eration is a directory 
write, so make sure you have adequate backups in this case. 

The "SELECT" error occurs vAien there is an attempt to address a drive 
beyond the A through D range. In this case, the value of x in the error 
message gives the selected drive. The system reboots following any input from 
the console. 

The "READ ONLY" message occurs v^ien there is an attempt to write to a 
diskette vhich has been designated as read-only in a STAT command, or has been 
set to read--only by the BDOS. In general, the operator should reboot CP/M 
either by using the warm start procedure (ctl-C) or by performing a cold start 
whenever the diskettes are changed. If a changed diskette is to be read but 
not written, BDOS allows the diskette to be changed without the warm or cold 
start, but internally marks the drive as read-only. The status of the drive 
is subsequently changed to read/write if a warm or cold start occurs. Upon 
issuing this message, CP/M waits for input from the console. An automatic 
warm start takes place following any input. 
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8. OPERATIC^ CF CP/M ON THE MDS. 

This section gives qperating procedures for using CP/M on the Intel MDS 
microcomputer development system. A basic knowledge of the MDS hardware and 
software systems is assumed. 

CP/M is initiated in essentially the same manner as Intel's ISIS 
operating system. The disk drives are labelled through 3 on the MDS> 
corresponding to CP/M drives A through D, respectively. The CP/M system 
diskette is inserted into drive 0, and the BOOT and RESET switches are 
depressed in sequence. The interrupt 2 light should go on at this point. The 
space bar is tten depressed on the device v^iich is to be taken as the system 
console, and the light should go out (if it does not, then check connections 
and baud rates) . The BOOT switch is then turned off, and the CP/M signon 
message should appear at the selected console device, followed by the "A>" 
system prompt. The user can then issue the various resident and transient 
commands 

The CP/M system can be restarted (warm start) at any time by pushing the 
INT switch on the front panel. The built-in Intel ROM monitor can be 
initiated by pushing the INT 7 switch (which generates a RST 7) , except vvhen 
operating under DDI, in v*iich case the DCT program gets control instead. 

Diskettes can be ronoved from the drives at any time, and the system can 
be shut down during operation without affecting data integrity. Note, 
however, that the user must not remove a diskette and replace it with another 
without rebooting the system (cold or warm start) , unless the inserted 
diskette is "read only. " 

Due to hardware hang-ups or malfunctions, CP/M may type the message 

BDOS ERR ON x: BAD SECTOR 

where x is the drive vAiich has a permanent error. This error may occur vdnen 
drive doors are opened and closed randomly, followed by disk operations, or 
may be due to a diskette, drive, or controller failure. The user can 
optionally elect to ignore the error by typing a single return at the 
console. The error may produce a bad data record, requiring re-initialization 
of up to 128 bytes of data. The operator can reboot the CP/M system and try 
the operation again. 

Termination of a CP/M session requires no special action, except that it 
is necessary to remove the diskettes before turning the power off, to avoid 
random transients which often make their way to the drive electronics. 

It should be noted that factory-fresh IBM-compatible diskettes should be 
used rather than diskettes viiich have previously been used with any ISIS 
version. In particular, the ISIS "POI^^AT" operation produces non-standard 
sector numbering throughout the diskette. This non-standard numbering 
seriously degrades the performance of CP/M, and will operate noticeably slower 
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than the distribution version. If it becomes necessary to reformat a diskette 
(which should not be the case for standard diskettes) , a program can be 
written under CP/M which causes the MDS 800 controller to reformat with 
sequential sector numbering (1-26) on each track. 



Note: "MDS 800" and "ISIS" are registered trademarks of Intel Corporation. 
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ED USER'S MANUAL 



1. ED TUTORIAL 

1.1. Introduction to ED. 

ED is the context editor for CP/M, and is used to create 
and alter CP/M source files. ED is initiated in CP/M by 
typing 

j <filenaine> 
ED / 

I <filenaine>«<filetype> 



In general, ED reads segments of the source file given by 
<filenaiTie> or <filename> . <filetype> into central memory, 
where the file is manipulated by the operator, and subse- 
quently written back to disk after alterations. If the 
source file does not exist before editing, it is created by 
ED and initialized to empty. The overall operation of ED 
is shown in Figure 1. 

1.2. ED Operation 

ED operates upon the source file, denoted in Figure 1 
by x.y, and passes all text through a memory buffer where 
the text can be viewed or altered (the number of lines which 
can be maintained in the memory buffer varies with the line 
length, but has a total capacity of about 6000 characters 
in a 16K CP/M system) . Text material which has been edited 
is written onto a temporary work file under command of the 
operator. Upon termination of the edit, the memory buffer 
is written to the temporary file, followed by any remaining 
(unread) text in the source file. The name of the original 
file is changed from x.y to x.BAK so that the most recent 
previously edited source file can be reclaimed if necessary 
(see the CP/M commands ERASE and RENAME) . The temporary 
file is then changed from x.$$$ to x.y which becomes the 
resulting edited file. 

The memory buffer is logically between the source file 
and working file as shown in Figure 2. 

1.3. Text Transfer Functions 

Given that n is an integer value in the range through 
65535, the following ED commands transfer lines of text 
from the source file through the memory buffer to the tem- 
porary (and eventually final) file: 




Figure 1. Overall ED Operation 




Source 
Libraries 




Note: the ED program accepts both lower and upper case ASCII 
characters as input from the console. Single letter commands 
can be typed in either case. The U command can be issued to 
cause ED to translate lower case alphabetics to upper case as 
characters are filled to the memory buffer from the console. 
Characters are echoed as typed without translation , however. 
The -U command causes ED to revert to "no translation" mode. 
ED starts with an assumed -U in effect. 



Figure 2. Memory Buffer Organization 
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Figure 3. Logical Organization of Memory Buffer 
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nA<cr> - append the next n unprocessed source 
lines from the source file at SP to 
the end of the memory buffer at MP. 
Increment SP and MP by n. 

nW<cr> - write the first n lines of the memory 

buffer to the temporary file free space. 
Shift the remaining lines n+1 through 
MP to the top of the memory buffer. 
Increment TP by n. 

E<cr> - end the edit. Copy all buffered text 
to temporary file, and copy all un- 
processed source lines to the temporary 
file. Rename files as described 
previously. 

H<cr> - move to head of new file by performing 
automatic E command. Temporary file 
becomes the new source file, the memory 
buffer is emptied, and a new temporary 
file is created (equivalent to issuing 
an E command, followed by a reinvocation 
of ED using x.y as the file to edit). 

0<cr> - return to original file. The memory 
buffer is emptied, the temporary file 
id deleted, and the SP is returned to 
position 1 of the source file. The 
effects of the previous editing commands 
are thus nullified. 

Q<cr> - quit edit with no file alterations, 
return to CP/M. 

There are a number of special cases to consider. If the 
integer n is omitted in any ED command where an integer is 
allowed, then 1 is assumed. Thus, the commands A and W append 
one line and write 1 line, respectively. In addition, if a 
pound sign (#) is given in the place of n, then the integer 
65535 is assumed (the largest value for n which is allowed) . 
Since most reasonably sized source files can be contained 
entirely in the memory buffer, the command #A is often issued 
at the beginning of the edit to read the entire source file 
to memory. Similarly, the command #W writes the entire buffer 
to the temporary file. Two special forms of the A and W 



*<cr> represents the carriage— return key 



commands are provided as a convenience. The command OA fills 
the current memory buffer to at least half-full^ while OW 
writes lines until the buffer is at least half empty. It 
should also be noted that an error is issued if the memory 
buffer size is exceded. The operator may then enter any 
command (such as W) which does not increase memory require- 
ments. The remainder of any partial line read during the 
overflow will be brought into memory on the next successful 
append. 

1.4. Memory Buffer Organization 

The memory buffer can be considered a sequence of source 
lines brought in with the A command from a source file. The 
memory buffer has an associated (imaginary) character pointer 
CP which moves throughout the memory buffer under command of 
the operator. The memory buffer appears logically as shown 
in Figure 3 where the dashes represent characters of the 
source line of indefinite length, terminated by carriage- 
return (<cr>) and line-feed (<lf>) characters, and fcp^ 
represents the imaginary character pointer. Note that the 
CP is always located ahead of the first character of the 
first line, behind the last character of the last line, or 
between two characters. The current line CL is the source 
line which contains the CP. 

1.5. Memory Buffer Operation 

Upon initiation of ED, the memory buffer is empty (ie, 
CP is both ahead and behind the first and last character) . 
The operator may either append lines (A command) from the 
source file, or enter the lines directly from the console 
with the insert command 

I<cr> 

ED then accepts any number of input lines, where each line 
terminates with a <cr> (the <lf> is supplied automatically) , 
until a control-z (denoted by fz is typed by the operator. 
The CP is positioned after the last character entered. The 
sequence 

I<cr> 

NOW IS THE<cr> 
TIME FOR<cr> 
ALL GOOD MEN<cr> 
f z 

leaves the memory buffer as shown below 




NOW IS THE<cr><lf> 
TIME FOR<cr><lf> 
ALL GOOD MEN<cr><lf> 



Various commands can then be issued ch manipulate the CP 
or display source text in the vicin-' ^ f the CP. The 
commands shown below with a prec. li^._, n indicate that an 
optional unsigned value can be specified. When preceded by 
±, the command can be unsigned, or have an optional preceding 
plus or minus sign. As before, the pound o jn (#) is replaced 
by 65535. If an integer n is optional, but not supplied, 
then n=l is assumed. Finally, if a plus sign is optional, 
but none is specified, then + is assumed. 

±B<cr> - move CP to beginning of memor buffer 
if +, and to bottom if -. 

±nC<cr> - move CP by ±n characters .rd front 
of buffer if +) , countint ^ <cr><lf > 
as two distinct characts 

±nD<cr> - delete n characters ahead of CP if plus 
and behinc CP if minus. 

±nK<cr> - kill (ie remove) ±n lines of source text 
using CP as the current reference. If 
CP is not at the beginning of the current 
line when K is issuea, then the charac- 
ters before CP remain if + is specified, 
while the characters after CP remain if - 
is given in the command. 

±nL<cr> - if n=0 then move CP to the beginning of 
the current Ij "e (if it is not already 
there) if n^^O len first move the CP to 
the begi^^ninc the current line, and 
thBn move it > the beginning of the 
line which is n lines down (if +) or up 
(if -) . The CP will stop at the top or 
bottom of the memory buffer if too large 
a value of n is specified. 



±nT<cr> - If n=0 then type the contents of the 
current line up to CP. If n=l then 
type the contents of the current line 
from CP to the end of the line. If 
n>l then type the current line along 
with n-1 lines which follow, if -f 
is specified. Similarly, if n>l and 
- is given, type the previous n lines, 
up to the CP. The break key can be 
depressed to abort long type-outs. 

±n<cr> - equivalent to ±nLT, which moves up or 
down and types a single line 

1.6. Command Strings 

Any number of commands can be typed contiguously (up to 
the capacity of the CP/M console buffer) , and are executed 
only after the <cr> is typed. Thus, the operator may use 
the CP/M console command functions to manipulate the input 
command : 



Rubout remove the last character 

Control-U delete the entire line 

Control-C re-initialize the CP/M System 

Control-E return carriage for long lines 
without transmitting buffer 
(max 12 8 chars) 



Appendix 



Suppose the memory buffer contains the characters shown 
in the previous section, with the CP following the last 
character of the buffer. The command strings shown below 
produce the results shown to the right 



Command String 
1. B2T<cr> 



Effect 

move to beginning 
of buffer and type 
2 lines: 
"NOW IS THE 
TIME FOR" 



Resulting Memory Buffer 

NOW IS THE<cr><lf> 
TIME FOR<cr><lf> 
ALL GOOD MEN<cr><lf> 



5C0T<cr> 



move CP 5 charac- 
ters and type the 
beginning of the 
line 
"NOW I" 



NOW I/\,S THE<cr><lf> 



3. 2L-T<cr> 



-L#K<cr> 



move tvjo lines down NOW IS THE<cr><lf> 

and type previous ^^^^ FOR<cr><lf> 

line 

"TIME FOR" ^. ALL GOOD MEN<cr><lf> 



move up one line, 
delte 65535 lines 
which follow 



NOW IS THE<cr>< 



"^^ 



I<cr> 

TIME TO<cr> 

INSERT<cr> 

f z 



-2L#T<cr> 



insert two lines 
of text 



move up two lines , 
and type 6 55 35 
lines ahead of CP 
"NOW IS THE" 



NOW IS THE<cr><lf> 
TIME TO<cr><lf> 
INSERT<cr><lf>/X, 

LEE] 

NOW IS THE<cr><lf> 
TIME TO<cr><lf> 
INSERT<cr><lf> 



<cr> 



move down one line 
and type one line 
"INSERT" 



NOW IS THE<cr><lf> 
TIME TO<cr><lf> 
INSERT<cr><lf> 



1.7. 



Text Search and Alteration 



ED also has a command which locates strings within the 
memory buffer. The command takes the form 



nF 



^1^2 



•••^k [^ +z j 



where c-]_ through cj^ represent the characters to match followed 
by either a <cr> or control -z*. ED starts at the current 
position of CP and attempts to match all k characters • The 
match is attempted n times, and if successful, the CP is 
moved directly after the character Cj^. If the n matches are 
not successful, the CP is not moved from its initial position. 
Search strings can include +1 (control-1) , which is replaced 
by the pair of symbols <cr><lf>. 



*The control-z is used if additional commands will be typed 
following the +z. 
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The following commands illustrate the use of the F 
command : 



Command String 
1. B#T<cr> 



Effect 

move to beginning 
and type entire 
buffer 



Resulting Memory Buffer 

NOW IS THE<cr><lf> 
TIME FOR<cr><lf> 
ALL GOOD MEN<cr><lf> 



FS T<cr> 



find the end of 
the string "S T" 



NOW IS T^^HE<cr><lf> 



3. FIfzOTT 



find the next "I" 
and type to the 
CP then type the 
remainder of the 
current line: 
"TIME FOR" 



NOW IS THE<cr><lf> 

TIXSME FOR<cr><lf> 
fcpj 

ALLSOOD MEN<cr><lf> 



An abbreviated form of the insert command is also allowed, 
which is often used in conjunction with the F command to make 
simple textual changes. The form is: 



I c^C2. 



c +z or 

n 



I Ct c^. . . c <cr> 
1 z n 
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where C]_ through c^^ are characters to insert. If the inser- 
tion string is terminated by a +z, the characters c^ through 
c^ are inserted directly following the CP, and the CP is 
moved directly after character c^. The action is the same 
if the command is followed by a <cr> except that a <cr><lf> 
is automatically inserted into the text following character 



-n" 



Consider the following command sequences as examples 



of the F and I commands : 



Command String 



Effect 



BITHIS IS ^z<cr> Insert "THIS IS ' 

at the beginning 
of the text 



Resulting Memory Buffer 
THIS IS i^OW THE <cr><lf> 

TIME FOR<cr><lf> 
ALL GOOD MEN<cr><lf> 



FTIMEtz-4DIPLACEfz<cr> 



THIS IS NOW THE<cr><lf> 



find "TIME" and delete 
it; then insert "PLACE" 



PLACE 



FOR<cr><lf> 



ALL GOOD MEN<cr><lf> 



3FOfz-3D5DICHANGESf<cr> 



find third occurrence 
of "0" (ie the second 
"0" in GOOD) , delete 
previous 3 characters; 
then insert "CHANGES" 



THIS IS NOW THE <cr><lf> 

PLACE FOR<cr><lf> 

ALL CHANGES /\<cr><lf> 
LEEl 



-8CIS0URCE<cr> 



move back 8 characters 
and insert the line 
"SOURCE<cr><lf>" 



THIS IS NOW THE<cr><lf> 

PLACE FOR<cr><lf> 

ALL SOURCE<cr><lf> 

/^ CHANGES <cr><lf> 
[£PJ 

ED also provides a single command which combines the F and 
I commands to perform simple string substitutions. The command 
takes the form 



n S CiC2...Cj^ + z d^d2...d^[<^f j 



and has exactly the same effect as applying the command string 



F Ct c^. . .c, +z-kDIdTd^. . .d 
12 K 12 m 



{<cr>\ 
tz ) 



a total of n times. That is, ED searches the memory buffer 
starting at the current position of CP and successively sub- 
stitutes the second string for the first string until the 
end of buffer / or until the substitution has been performed 
n times. 

As a convenience, a command similar to F is provided by 
ED which automatically appends and writes lines as the search 
proceeds. The form is 



n N c^ c^. 



(fz) 



which searches the entire source file for the nth occurrence 
of the string 02^02* ••c^ (recall that 'F fails if the string 
cannot be found in the current buffer) . The operation of the 
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IJ command is precisely the same as F except in the case that 
the string cannot be found within the current memory buffer. 
In this case, the entire memory contents is written (ie, an 
automatic #W is iss ^^d) . Input lines are then read until 
the buffer is at least half full, or the entire source file 
is exhausted. The search continues in this manner until the 
string has been found n times, or until the source file has 
been completely transferred to the temporary file. 

A final line editing function, called the juxtaposition 
command takes the form 



n J CtC^...c, +z dTd^...d fz e,e^...e 
12 k 12 m 12 q 



C?r) 



with the following action applied n times to the memory buffer: 
search from the current CP for the next occurrence of the 
string C2^C2-»*Cj,. If found, insert the string ^^^2^ - • rd^f 
and move CP to follow d^. Then delete all characters following 
CP up to (but not including) the string e-L ,e2 / • . • e^, leaving 
CP directly after dj^. If e2^,e2/.«*eq cannot be found, then 
no deletion is made. If the current line is 

XSNOW IS THE TIME<cr><lf> 



Then the command 

JW fzWHATtZ'M<cr> 
Results in 



NOW WHAT y^ <cr><lf> 

(Recall that +1 rep. jents the pair <cr><lf> in search and 
substitute strings) . 

It should be noted that the number of characters allowed 
by ED in the F,S,N, and J commands is limited to 100 symbols. 

1.8. Source Libraries 

ED also allows he inclusion of source libraries during 
the editing process with the R command. The form of this 
command is 
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R f , f ^. . f f z or 
12 n 



R f^ f ^. . f <cr> 
1 2 n 



where f]_f2..fn is the name of a source file on the disk with 
as assumed filetype of 'LIB' • ED reads the specified file, 
and places the characters into the memory buffer after CP, 
in a manner similar to the I command. Thus, if the command 

RMACRO<cr> 

is issued by the operator, ED reads from the file MACRO. LIB 
until the end-of-file, and automatically inserts the charac- 
ters into the memory buffer. 

1. 9. Repetitive Command Execution 

The macro command M allows the ED user to group ED com- 
mands together for repeated evaluation. The M command takes 
the form: 



n M c, C2« • • c. 



t?r) 



where C]_C2...C]^ represent a string of ED commands, not inclu- 
ding another M command. ED executes the command string n 
times if n>l. If n=0 or 1, the command string is executed 
repetitively until an error condition is encountered (e.g., 
the end of the memory buffer is reached with an F command) . 

As an example, the following macro changes all occur- 
rences of GAMMA to DELTA within the current buffer, and 
types each line which is changed: 



MFGAMMA+z-5DIDELTA+zOTT<cr> 
or equivalently 

MSGAMMAfzDELTAfzOTT<cr> 
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2. ED ERROR CONDITIONS 

On error conditions, ED prints the last character read 
before the error, along with an error indicator: 

? unrecognized coinmand 

> memory buffer full (use one of 
the commands D,K,N,S, or W to 
remove characters), F,N, or S 
strings too long. 

# cannot apply command the number 
of times specified (e.g. , in 
F command) 

cannot open LIB file in R 
command 

Cyclic redundancy check (CRC) information is written with 
each output record under CP/M in order to detect errors on 
subsequent read operations. If a CRC error is detected, CP/M 
will type 

PERM ERR DISK d 



where d is the currently selected drive (A,B,...). The oper- 
ator can choose to ignore the error by typing any character 
at the console (in this case, the memory buffer data should 
be examined to see if it was incorrectly read) , or the user 
can reset the system and reclaim the backup file, if it 
exists. The file can be reclaimed by first typing the con- 
tents of the BAK file to ensure that it contains the proper 
information: 

TYPE x.BAK<cr> 

where x is the file being edited. Then remove the primary 
file: 

ERA x.y<cr> 

and rename the BAK file: 

REN x.y=x.BAK<cr> 

The file can then be re-edited, starting with the previous 
version. 
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3. CONTROL CHARACTERS AND COMMAI^DS 

The following table summarizes the control characters 
and commands available in ED: 



Control Character 

tc 
f e 



fi 
fl 

fu 

\z 
rubout 
break 



Function 

system reboot 

physical <cr><lf> (not 
actually entered in 
command) 

logical tab (cols 1,8, 
15,. . •) 

logical <cr><lf> in 
search and substitute 
strings 

line delete 

string terminator 

character delete 

discontinue command 
(e.g. , stop typing) 
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Coininand Function 

nA append lines 

±B begin bottom of buffer 

±nC move character positions 

±nD delete characters 

E end edit and close files 

(normal end) 

nF find string 

H end edit, close and reopen 

files 

I insert characters 

nJ place strings in juxtaposition 

±nK kill lines 

±nL move down/up lines 

nM macro definition 

nN find next occurrence with 

autoscan 

return to original file 

±nP move and print pages 

Q quit with no file changes 

R read library file 

nS substitute strings 

±nT type lines 

± translate lower to upper case if U, 

no translation if -U 

nW write lines 

nZ sleep 

±n<cr> move and type (±nLT) 
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Appendix A: ED 1.4 Enhancements 

The ED context editor contains a number of commands which enhance its 
usefulness in text editing. The improvements are found in the addition of line numbers, 
free space interrogation, and improved error reporting. 

The context editor issued with CP/M 1.4 produces absolute line number prefixes 
when the "V" (Verify Line Numbers) command is issued. Following the V command, 
the line number is displayed ahead of each line in the format: 

nnnnn: 

where nnnnn is an absolute line number in the range 1 to 65535. If the memory buffer 
is empty, or if the current line is at the end of the memory buffer, then nnnnn appears 
as 5 blanks. 

The user may reference an absolute line number by preceding any command by 
a number followed by a colon, in the same format as the line number display. In this 
case, the ED program moves the current line reference to the absolute line number, 
if the line exists in the current memory buffer. Thus, the command 

345 :T 

is interpreted as "move to absolute line 345, and type the line.'^ Note that absolute 
line numbers are produced only during the editing process, and are not recorded with 
the file. In particular, the line numbers wiU change following a deleted or expanded 
section of text. 

The user may also reference an absolute line number as a backward or forward 
distance from the current line by preceding the absolute line number by a colon. Thus, 
the command 

:400T 

is interpreted as "type from the current line number through the line whose absolute 
number is 400." Combining the two line reference forms, the command 

345::400T 

for example, is interpreted as "move to absolute line 345, then type through absolute 
line 400." Note that absolute line references of this sort can precede any of the 
standard ED commands. 

A special case of the V command, "0V", prints the memory buffer statistics in 
the form: 

free/total 

where "free" is the number of free bytes in the memory buffer (in decimal), and "total" 
is the size of the memory buffer. 




ED 1.4 also includes a "block move" facility implemented through the "X" (Xfer) 
command. The form 

nX 

transfers the next n lines from the current line to a temporary file called 

X$$$$$?$.LIB 

which is active only during the editing process. In general, the user can reposition 
the current line reference to any portion of the source file and transfer lines to the 
temporary file. The transferred line accumulate one after another in this file, and 
can be retrieved by simply typing: 

R 

which is the trivial case of the library read command. In this case, the entire 
transferred set of lines is read into the memory buffer. Note that the X command 
does not remove the transferred lines from the memory buffer, although a K command 
can be used directly after the X, and the R command does not empty the transferred 
line file. That is, given that a set of lines has been transferred with the X command, 
they can be re-read any number of times back into the source file. The command 

(^X 

is provided, however, to empty the transferred line file. 

Note that upon normal completion of the ED program through Q or E, the 
temporary LIB file is removed. If ED is aborted through ctl-C, the LIB file will exist 
if lines have been transferred, but will generally be empty (a subsequent ED invocation 
wiU erase the temporary file). 

Due to common typographical errors, ED 1.4 requires several potentially disas- 
terous commands to be typed as single letters, rather than in composite commands. 
The commands 

E (end), H (head), O (original), Q (quit) 

must be typed as single letter commands. 

ED 1.4 also prints error messages in the form 

BREAK "X" AT c 

where x is the error character, and c is the command where the error occurred. 
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1. AiSI 0VERV1E\'^ OF CP/M 2.0 FACILITIES. 
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File expansion is achieved by providing, up to 512 logical 
extents, where each logical extent contains 16K bytes of data. 
2.0 is structured, nowever, so that as much as 128K bytes of 
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Several CP/M 2.0 modules and utilities have improvements which 
correspond to the enhanced file system. STAT and PIP both account for 
file attributes and user areas, while the CCP provides a "login" 
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function to change from one user area to anotner. Tne CCP also 
formats directory displays in a more convenient manner and accounts 
for both CRT and hard-copy devices in its enhanced line editing 
functions. 

The sections below point out the individual differences between 
CP/M 1.4 and CP/M 2.0, with the understanding that the reader is 
either familiar with CP/M 1.4, or has access to the 1.4 manuals. 
Additional information dealing with CP/M 2.0 I/O system alteration is 
presented in the Digital Research manual "CP/M 2.0 Alteration Guide." 
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!. USER INTERFACE. 

Console line processing takes CRT-type devices into account with 

:liree new control characters, shown with an asterisk in the list below 

[the symbol "ctl*' below indicates that the control key is 
iimultaneously depressed) : 

rub/del removes and echoes last character 

ctl-C reboot when at beginning of line 

ctl-E physical end of line 

ctl-H oackspace' one cnaracter position* 

ctl-J (line feed) terminates current input* 

ctl-M (carriage return) terminates input 

ctl-R retype current line after new line 

ctl-U remove current line after new line 

ctl-X backspace to beginning of current line* 

[n particular, note that ctl-H produces the proper backspace overwrite 
Eunction (ctl-H can be changed internally to another cnaracter, such 
as delete, through a simple single byte change) . Further, the line 
editor keeps track of the current prompt column position so that the 
operator can properly align data input following a ctl-U, ctl-R, or 
::tl-X command. 
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3, CONSOLE COMMAND PROCESSOR (CCP) INTERFACE. 

There are four functional differences between CP/M 1.4 and CP/M 
2.0 at the console command processor (CCP) level. The CCP now 
displays directory information across the screen (four elements per 
line) , the USER command is present to allow maintenance of separate 
files in the same directory, and the actions of the "ERA *.*" and 
"SAVE" commands have changed. The altered DIR format is 
self-explanatory, while the USER command takes the form: 

USER n 

where n is an integer value in the range to 15. Upon cold start, 
the operator is automatically "logged" into user area number 0, which 
is compatible with standard CP/M 1.4 directories. The operator may 
issue the USER command at any time to move to another logical area 
within the same directory. Drives which are logged-in while 
addressing one user number are automatically active when the operator 
moves to another user numoer since a user number is simply a prefix 
which accesses particular directory entries on. the active disks. 

The active user number is maintained until changed by a 
subsequent USER command, or until a cold start operation when user 
is again assumed. 

Due to the fact that user numbers now tag individual directory 
entries, the ERA *.* command has a different effect. In version 1.4, 
this command can be used to erase a directory whicn has "garbage" 
information, perhaps resulting from use of a diskette under another 
operating system (heaven foroid!). In 2.0, however, the ERA ^.* 
command affects only the current user numoer. Thus, it is necessary 
to write a simple utility to erase a nonsense disk (the program simply 
writes the hexadecimal pattern E5 throughout the disk). 

The SAVE command in version 1.4 allows only a single memory save 
operation, with the potential of destroying the memory image due to 
directory operations following extent boundary changes. Version 2.0, 
nowever, does not perform directory operations in user data areas 
after disk writes, and thus the SAVE operation can be used any number 
of times without altering the memory image. 
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4. STAT Eil^HANCeMENTS. 

The STAT program has a number of additional functions which 
allow disk parameter display, user number displayr and file indicator 
manipulation. The command: 

STAT VAL: 

produces a summary of the available status commands, resulting in the 
output: 

Temp R/0 Disk: d:=R/0 

Set Indicator: d :f ilename . typ $R/0 $R/vV $SYS $DIR 

Disk Status : DSK : d:D3K: 

User Status : USR: 

lobyte Assign: 

(list of possible assignments) 

whicn gives an instant summary of the possible STAT commands. The 
command form: 

STAT d:f ilename. typ ^S 

wnere "d:" is an optional drive name, and "filename. typ" is an 

unambiguous or ambiguous file name, produces the output .display 
format: 

Size Recs Bytes Ext Ace 

48 48 6k 1 R/0 A: ED.COM 

55 55 12k 1 R/0 (A:PIP.COM) 

65536 128 2k 2 R/W A:X.DAT 

where tne $S parameter causes the "Size" field to be displayed 
(without the $S, the Size field is skipped, but the remaining fields 
are displayed) . The Size field lists the virtual file size in 
records, while the "Recs" field sums the number of virtual records in 
each extent. For files constructed sequentially, the Size and Recs 
fields are identical. The "Bytes" field lists the actual number of 
bytes allocated to the corresponding file. The minimum allocation 
unit is determined at configuration time, and thus tne number of bytes 
corresponds to the record count plus the remaining unused space in the 
last allocated block for sequential files. Random access files are 
given data areas only wnen written, so the Bytes field contains the 
only accurate allocation figure. In the case of random access, the 
Size field gives the logical end-of-file record position and the Recs 
field counts the logical records of each extent (each of these 
extents, nowever, may contain unallocated "holes" even though they are 
added into the record count). The "Ext" field counts the number of 
logical 16K extents allocated to the file. Unlike version 1.4, the 
Ext count does not necessarily correspond to the number of directory 
entries given to the file, since there can be up to 128K oytes (8 
logical extents) directly addressed by a single directory entry, 
depending upon allocation size (in a special case, there are actually 
256K bytes which can be directly addressed by a physical extent) . 

The "Ace" field gives the R/0 or R/vV access mode, which is 
changed using the commands shown below. Similarly, the parentheses 

(All Information Contained Herein is Proprietary to Digital Research. ) 

5 




snown around the PIP.COM file name indicate that it has the ''system" 
indicator set, so that it will not be listed in DIR commands. The 
four command forms 

STAT d:f ilename. typ ^R/0 
STAT d:f ilename. typ $R/W 
STAT d:f ilename. typ :?SYS 
STAT d:f ilename. typ $DIR 

set or reset various permanent file indicators. The R/0 indicator 
places the file (or set of files) in a read-only status until changed 
by a subsequent STAT command. The R/0 status is recorded in the 
directory with tne file so that it remains R/0 through intervening 
cold start operations. The R/W indicator places the file in a 
permanent read/write status. The SYS indicator attaches the system 
indicator to the file, while the DIR command removes the system 
indicator. The "filename. typ" may be ambiguous or unambiguous, but in 
eitner case, the files whose attributes are changed are listed at the 
console when the change occurs. The drive name denoted by "d:" is 
optional. 

When a file is marked R/0, subsequent attempts to erase or write 
into the file result in a terminal BDOS message 

Bdos Err on d: File R/0 

The BOOS then waits for a console input before performing a subsequent 
warm start (a "return" is sufficient to continue) . The command form 

STAT d:DSK: 

lists the drive characteristics of the disk named by "d:" which is in 
tne range A:, B:, ..., P:. The drive characteristics are listed in 
the format: 

d: Drive Characteristics 

65536: 128 Byte record Capacity 

8192: KiloDyte Drive Capacity 

128: 32 Byte Directory Entries 

0: Checked Directory Entries 

1024: Records/ Extent 

128: Records/ Block 

58: Sectors/ Track 

2: Reserved Tracks 

where "d:" is the selected drive, followed by the total record 
capacity (65536 is an 8 megabyte drive) , followed by the total 
capacity listed in Kilobytes. The directory size is listed next, 
followed by the "checked'* entries. The number of checked entries is 
usually identical to the directory size for removable media, since 
this mechanism is used to detect changed media during CP/M operation 
without an intervening warm start. For fixed media, the number is 
usually zero, since the media is not changed without at least a cold 
or warm start. The number of records per extent determines the 
addressing capacity of each directory entry (1024 times 128 bytes, or 
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i28K in the example above) . The number of records per Dlock shows the 
basic allocation size (in the example^ 128 records/olock times 128 
bytes per record, or 16K oytes per block) . The listing is then 
followed by the number of physical sectors per track and the number of 
reserved tracks. For logical drives which share the same physical 
disk, the number of reserved tracks may be quite large, since this 
mechanism is used to skip lower-numbered disk areas allocated to other 
logical disks. The command form 

STAT DSK: 

produces a drive characteristics taole for all currently active 
drives. The final STAT command form is 

STAT USR: 

which produces a list of the user numbers whicn have files on the 
currently addressed disk. The display format is: 

Active User : 
Active Files: 13 

where the first line lists the currently addressed user number, as set 
by the last CCP USER command, followed by a list of user numbers 
scanned from the current directory. In the above case, the active 
user number is (default at cold start) , witn three user numbers 
whicn have active files on the current disk. The operator can 
subsequently examine the directories of the other user numbers by 
logging-in with USER 1, USER 2, or USER 3 commands, followed by a DIR 
command at the CCP level. 



■ 
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5. PIP ENHANCEMEiSITS. 

PIP provides three new functions whicn account for the features 
of CP/M 2.0. All three functions take the form of file parameters 
which are enclosed in square brackets following the appropriate file 
names. The commands are: 

Gn Get File from User number n 
(n in the range - 15) 

W Write over R/0 files without 
console interrogation 

R Read system files 

The G command allows one user area to receive data files from another. 
Assuming the operator has issued the USER 4 command at the CCP level, 
the PIP statement 

PIP X.Y = X.Y[G2] 

reads file X.Y from user number 2 into user area number 4. The 
command 

PIP A:=A:*.*[G2] 

copies all of the files from the A drive directory for user number 2 
into the A drive directory of the currently logged user number. Note 
tnat to ensure file security, one cannot copy files into a different 
area than the one which is currently addressed by the USER command. 

Note also that the PIP program itself is initially copied to a 
user area (so that subsequent files can be copied) using the SAVE 
command. The sequence of operations shown below effectively moves PIP 
from one user area to the next. 

USER login user 

DDT PIP.COM load PIP to memory 

(note PIP size s) 

G0 return to CCP 

USER 3 login user 3 

SAVE s PIP.COM 

where s is the integral number of memory "pages'* (256 byte segments) 
occupied by PIP. The number s can be determined when PIP.COM is 
loaded under DDT, by referring to the value under the "NEXT" display. 
If for example, the next available address is 1D00, then PIP.COM 
requires IC hexadecimal pages (or 1 times 16+12 = 28 pages) , and 
thus the value of s is 28 in the subsequent save. Once PIP is copied 
in this manner, it can then be copied to another disk belonging to the 
same user number through normal pip transfers. 

Under normal operation, PIP will not overwrite a file which is 
set to a permanent R/0 status. If attempt is made to overwrite a R/0 
file, the promot 
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nPSTINATION FILE 13 R/0, DELETE {"i/U)? 

is issued. If the operator responds with the character "y" then the 
file is overwritten. Otherwise^ the response 

** NOT DELETED ** 

is issued, the file transfer is skippped, and PIP continues with the 
next operation in sequence. In order to avoid the prompt and response 
in the case of R/0 file overwrite, the command line can include the W 
parameter, as shown below 

PIP A:=B:*.COM[W] 

which copies all non-system files to. the A drive from the B drive, and 
overwrites any R/0 files in the process. If the operation involves 
several concatenated files, the W parameter need only be included with 
the last file in the list, as shown in the following example 

PIP A. DAT = B.DAT,F:i\fEW.DAT,G:OLD.DAT[W] 

Files with the system attribute can be included in PIP transfers 
if the R parameter is included, otherwise system files are not 
recognized. The command line 

PIP ED.COM = 3:ED.C0M[R] 

for example, reads the ED.COM file from the B drive, even if it has 
been marked as a R/0 and system file. The system file attributes are 
copied, if present. 



It should be noted that downward compatibility with previous 
versions of CP/M is only maintained if the file does not exceed one 
megabyte, no file attributes are set, and the file is created by user 
0* If compatibility is required with non-standard (e.g., "double 
density") versions of 1.4, it may be necessary to select 1.4 
compatibility mode when constructing the internal disk parameter block 
(see the "CP/M 2.0 Alteration Guide," and refer to Section 10 which 
describes BIOS differences) . 
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6. ED ENHANCEMENTS. 

The CP/M standard program editor provides several new facilities 
in the 2.0 release. Experience has shown that most operators use the 
relative line numbering feature of ED, and thus the editor has the "v" 
(Verify Line) option set as an initial value. The operator can^ of 
course, disable line numbering by typing the "-v" command. If you are 
not familiar with the ED line number mode, you may wish to refer to 
the Appendix in the ED user's guide, where the "v" command is 
described. 

ED also takes file attributes into account. If the operator 
attempts to edit a read/only file, the message 

** FILE IS READ/ONLY ** 

appears at the console. The file can be loaded and examined, but 
cannot be altered in any way. Normally, the operator simply ends the 
edit session, and uses STAT to change the file attribute to R/W. If 
the edited file has the "system" attribute set, the message 

"SYSTEM" FILE NOT ACCESSIBLE 

is displayed at the console, and the edit session is aborted. Again, 
the STAT program can be used to change the system attribute, if 
desired. 

Finally, the insert mode ("i") command allows CRT line editing 
functions, as described in Section 2, above. 
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1 . THE XSUB FUNCTION. 

An additional utility program is supplied with version 2.0 of 
CP/M, called XSUB^ which extends the power of the SUBMIT facility to 
include line input to programs as well as the console command 
processor. The XSUB command is included as the first line of your 
submit file and, when executed, self-relocates directly below the CCP. 
All subsequent submit command lines are processed by XSUB^ so that 
programs which read buffered console input (BDOS function 10) receive 
their input directly from the submit file. For example, the file 
SAVER. SUB could contain the submit lines: 

XSUB 

DDT 

I$1.HEX 

R 

G0 

SAVE 1 $2. COM 

with a subsequent SUBMIT command: 

SUBMIT SAVER X Y 

which substitutes X for $1 and Y for $2 in the command stream. The 
XSUB program loads, followed by DDT which is sent the command lines 
•'IX. HEX" "R" and "G0" thus returning to the CCP. The final command 
"SAVE 1 Y.COM" is processed by the CCP. 

The XSUB program remains in memory, and prints the message 

(xsub active) 

on each warm start operation to indicate its presence. Subsequent 
submit command streams do not recruire the XSUB, unless an intervening 
cold start has occurred. Note that XSUB must be loaded after DESPOOL, 
if both are to run simultaneously. 
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8. BDOS INTERFACE COiWENTIONS, 



CP/M 2.0 system calls take place in exactly the same manner as 
earlier versions, with a call to location 0005H, function number in 
register C, and information address in register pair DE. Single byte 
values are returned in register A, with double byte values returned in 
HL (for reasons of compatibility , register A =• L and register B = H 
upon return in all cases). A list of CP/M 2.0 calls is 
with an asterisk following functions which are either 
from version 1.4 to 2.0. Note that a zero value is 
out-of range function numbers. 



given below, 
new or revised 
returned for 



System Reset 19* 

1 Console Input 20 

2 Console Output 21 

3 Reader Input 22* 

4 Puncn Output 23* 

5 List Output 24* 
6* Direct Console I/O 25 

7 Get I/O Byte 26 

3 Set I/O Byte 27 

9 Print String 28* 

10* Read Console Buffer 29* 

11 Get Console Status 30* 

12* Return Version Number 31* 

13 Reset Disk System 32^^ 

14 Select Disk 33* 
15* Open File 34* 
16 close File 35* 
17* Search for First 36* 
18* Search for Next 



Delete File 
Read Sequential 
v^rite Sequential 
Make File 
Rename File 
Return Login Vector 
Return Current Disk 
Set DMA Address 
Get Addr (Alloc) 
Write Protect Disk 
Get Addr(R/0 Vector) 
Set File Attributes 
Get Addr(Disk Parms) 
Set/Get User Code 
Read Random 
Write Random 
Comoute File Size 
Set Random Record 



(Functions 28, 29, and 32 should be avoided in application programs to 
maintain upward compatibility with MP/M.) The new or revised functions 
are described below. 



Function 6: Direct Console I/O. 

Direct Console I/O is supported under CP/M 2.0 for those 
applications where it is necessary to avoid the BDOS console I/O 
operations. Programs whicn currently perform direct I/O through the 
3I0S should be changed to use direct I/O under BDOS so that they can 
be fully supported under future releases of MP/M and CP/M. 

Upon entry to function 6, register E eitner contains hexadecimal 
FF, denoting a console input request, or register E contains an ASCII 
cnaracter. If the input value is FF, then function 6 returns A = 00 
if no character is ready, otherwise A contains the next console input 
character. 



If the input value in £ is not FF, then function 6 assumes 
£ contains a valid ASCII character which is sent to the console. 



that 
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Function 10: Read Console Suffer. 

The console buffer read operation remains unchanged except that 
console line editing is supported, as described in Section 2. Note 
also that certain functions which return the carriage to the leftmost 
position (e.g., ctl-X) do so only to the column position where the 
prompt ended (previouslyr the carriage returned to the extreme left 
margin) . This new convention makes operator data input and line 
correction more legible. 



Function 12: Return Version Number. 



Function 12 has been re 
allows version-independent pr 
head" function which returned 
operation) . The value returne 
with H = 00 for the CP/M relea 
releases previous to 2.0. 
register L, with subsequent ve 
range 21, 22, through 2F. 
write application programs whi 
access functions, with rand 
early releases of CP/M. 



defined to 
ogramming ( 
HL=0000 in 
d by functi 
se (H = 01 

CP/M 2.0 
rsion 2 r 
Using func 
ch provide 
om access 



orovide 
this was pr 
version 1.4 
on 12 is a 
for MP/M) , 

returns a 
eleases in 
tion 12, fo 
both seque 
disabled wh 



informat 
eviously 
, but pe 

two-by 
and L = 
hexadec 

the h 
r exampl 
ntial a 
en opera 



ion which 
the "lift 
rformed no 
te value, 
00 for all 
imal 20 in 
exadecimal 
e, you can 
nd random 
ting under 



In the file operations described below, DE addresses a file 
control block (FCB) . Further, all directory operations take place in 
a reserved area which does not affect write buffers as was the case in 
version 1.4, with the exception of Searcn First and Search Next, where 
compatibility is required. 



The File Control Block (FCB) 
bytes for sequential access. 



data area consists of a 
and a series of 36 bytes 



sequence of 33 
in the case that 



the file is accessed randomly, 
normally located at 005CH can be used 
bytes 007DH, 007EH, and 007FH are 
notational purposes, the FCB format 
fields : 



The default file control block 

for random access files, since 

available for this purpose. For 

is shown with the following 
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|dr|fl|f2|/ /|f8| tl|t2| tSlexl sl|s2|rc|d0|/ / |dn I cr I r0 I rl I r2 I 
00 01 02 ... 08 09 10 11 12 13 14 15 16 ... 31 32 33 34 35 



where 



dr drive code (0 - 16) 

=> use default drive for file 

1 => auto disk select drive A, 

2 => auto disk select drive B, 
• • • 

16=> auto disk select drive P. 

fl...f8 contain the file name in ASCII 
upper case, with high 'bit = 

tl,t2,t3 contain the file type in ASCII 
upper case, with high bit = 
ti', t2\ and t3' denote the 
bit of these positions, 
tl' = 1 => Read/Only file, 
t2* = 1 => SYS file, no DIR list 

ex contains the current extent number, 
normally set to 00 by the user, but 
in range 0-31 during file I/O 

si reserved for internal system use 

s2 reserved for internal system use, set 
to zero on call to OPEN, MAKE, SEARCH 

re record count for extent "ex," 
takes on values from - 128 

d0...dn filled-in by CP/M, reserved for 
system use 

cr current record to read or write in 

a sequential file operation, normally 
set to zero by user 

r0,rl,r2 optional random record number in the 
range 0-65535, with overflow to r2, 
r0,rl constitute a 16-bit value with 
low byte r0, and high byte rl 



Function 15: Open File. 

Tne Open File operation is identical to previous definitions, 
with the exception that byte s2 is automatically zeroed. Note that 
previous versions of CP/M defined this byte as zero, but made nc 
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cnecks to assure compliance. Thus, the byte is cleared to ensure 
upward compatibility with the latest version, where it is required. 



Function 17: Search for First. 

Search First scans the directory for a match with the file given 
by the FC3 addressed by DE. The value 255 (hexadecimal FF) is 
returned if the file is not found, otherwise a value of A equal to 0, 
1, 2, or 3 is returned indicating the file is present. In the case 
that the file is found, the current DMA address is filled with the 
record containing the directory entry, and the relative starting 
position is A ^ 32 (i.e., rotate the A register left 5 bits, or ADD A 
five times). Altnough not normally required for application programs, 
the directory information can be extracted from the buffer at this 
position. 



An ASCII question mark (63 decimal, 
position from fl through ex matches the 
directory entry on the default or auto-sele 
field contains an ASCII question mark, th 
function is disabled, the default disk i 
function returning any matched entry, alloc 
any user number. This latter functio 
application programs, out does allow comple 
current directory values. If the dr field 
s2 byte is automatically zeroed. 



3F hexadecimal) in any 
corresponding field of any 
cted disk drive. If the dr 
en the auto disk select 
s searched, with the search 
ated or free, belonging to 
n is not normally used by 
te flexibility to scan all 
is not a Question mark, the 



Function 18: Search for Next. 



The Search Next function is similar to the Search First 
function, except that the directory scan continues from the last 
matched entry. Similar to function 17, function 18 returns the 
decimal value 255 in A when no more directory items match. 



Function 19: Delete File. 

The Delete File function removes files which match the FCB 
addressed by DE. The filename and type may contain ambiguous 
references (i.e., question marks in various positions), but the drive 
select code cannot be ambiguous, as in the Search and Search LSIext 
functions. 

Function 19 returns a decimal 255 if the reference file or files 
could not be found, otherwise a value in the range to 3 is returned. 
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Function 22: Make File. 

The Make File operation is identical to previous versions ot 
CP/Mr except that byte s2 is zeroed upon entry to the BDOS. 



Function 23: Rename File. 

The Actions of the file rename functions are the same as 
previous releases except that the value 255 is returned if the rename 
function is unsuccessful (the file to rename could not be found) , 
otherwise a value in the range to 3 is returned. 



Function 24: Return Login Vector. 

The login vector value returned by CP/M 2.0 is a 16-bit value in 
HL, where the least significant bit of L corresponds to the first 
drive A, and the high order bit of H corresponds to the sixteenth 
drive, labelled P. Note that compatibility is maintained with earlier 
releases, since registers A and L contain the same values upon return. 



Function 28: Write Protect Current Disk. 

The disk write protect function provides temporary write 

protection for the currently selected disk. Any attempt to write to 

the disk, before the next cold or warm start operation produces the 
message 

Bdos Err on d: R/0 



Function 29: Get R/0 Vector. 

Function 29 returns a bit vector in register pair HL which 
indicates drives which have the temporary read/only bit set. Similar 
to function 24, the least significant oit corresponds to drive A, 
while the most significant bit corresponds to drive P. The R/0 bit is 
set either by an explicit call to function 28, or by the automatic 
software mechanisms within CP/M which detect changed disks. 



Function 30: Set File Attributes. 

The Set File Attributes function allows programmatic 
manipulation of permanent indicators attached to files. In 
particular, the R/0 and System attributes (tl' and t2' above) can be 
set or reset. The D£ pair addresses an unambiguous file name with the 
appropriate attributes set or reset. Function 30 searches for a 
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latchr and chanqes the Tnatched directory entry to contain the selected 
naicators. Indicators fl* through f4* are not presently used, but 
lay be useful for applications programs, since they are not involved 
n the matching process during file open and close operations. 
ndicators f5* tnrough f8* and t3 ' are reserved for future system 
xoansion. 



Function 31: Get Disk Parameter Block Address. 

The address of the BIOS resident disk parameter block is 
eturned in HL as a result of this function call. This address can be 
sed for either of two purposes. First, the disk parameter values can 
le extracted for display and space computation purposes, or transient 
rograms can dynamically change the values of current disk parameters 
hen the disk environment changes, if required. Normally, application 
Tograms will not require this facility. 



Function 32: Set or Get User Code. 

An application program can change or interrogate the currently 
ctive user number Dy calling function 32. If register E = FF 
exaciecimal, then tne value of the current user number is returned in 
egister A, where the value is in the range to 31. If register E is 
ot FF, then the current user number is changed to the value of E 
modulo 32) , 



Function 33: Read Random. 



The Read Random function is simi 
peration of previous releases, exce 
lace at a particular record number, 
onstructed from the three byte f 
ositions r0 at 33, rl at 34, and r2 a 
f 24 bits is stored with least sig 
yte next (rl) , and high byte last (r2 
eference byte r2, except in comput 
5). Byte r2 must be zero, however, s 
verflow past the end of file. 



lar to the sequential 
pt that the read oper 
selected by the 24 
ield following the 
t 35) . Note that th 
nificant byte first ( 
) . CP/M release 2.0 
ing the size of a fil 
ince a non-zero value 



file read 

ation takes 

-bit value 

FCB (byte 

e sequence 

r0) , middle 

does not 

e (function 

indicates 



Thus, in version 2.0, the r0 
ouble-byte, or "word" value, which 
alue ranges from to 65535, 
ecord of the 8 megabyte file. In 
andom access, the base extent 
Itnough the case extent may or may 
his ensures that the file is prop 
s visible in DIR requests. The se 
nto the random record field (r0,rl 
he record. Upon return from the 



,rl byte 
contains 
providing 
order to 
(extent 
not conta 
erly recor 
lected rec 
) , and the 
call, regi 



pair 
the rec 

access 
oroce 
id) mus 
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error code^ as listed below, or the value 00 indicating the operation 
was successful. In the latter case, the current DMA address contains 
the randomly accessed record. Note that contrary to the sequential 
read operation, the record number is not advanced. Thus, subsequent 
random read operations continue to read the same record. 

Upon each random read operation, the logical extent and current 
record values are automatically set. Thus, the file can be 
sequentially read or written, starting from the current randomly 
accessed position. Note, however, that in this case, the last 
randomly read record will be re-read as you switch from random mode to 
sequential read, and the last record will be re-written as you switch 
to a sequential write operation. You can, of course, simply advance 
the random record position following each random read or write to 
obtain the effect of a sequential I/O operation. 

Error codes returned in register A following a random read are 
listed below. 

01 reading unwritten data 

02 (not returned in random mode) 

03 cannot close current extent 

04 seek to unwritten extent 

05 (not returned in read mode) 

06 seek past physical end of disk 

Error code 01 and 04 occur when a random read operation accesses a 
data block which has not been previously written, or an extent which 
has not been created, which are equivalent conditions. Error 3 does 
not normally occur under proper system operation, but can be cleared 
by simply re-reading, or re-opening extent zero as long as the disk is 
not physically write protected. Error code 06 occurs whenever byte r2 
is non-zero under the current 2.0 release. Normally, non-zero return 
codes can be treated as missing data, with zero return codes 
indicating operation complete. 



Function 34: Write Random. 

The Write Random operation is initiated similar to the Read 
Random call, except that data is written to the disk from the current 
DMA address. Further, if the disk extent or data block which is the 
target of the write has not yet been allocated, the allocation is 
performed before the write operation continues. As in the Read Random 
operation, the random record number is not changed as a result of the 
write. The logical extent number and current record positions of the 
file control block are set to correspond to the random record which is 
being written. Again, sequential read or write operations can 
commence following a random write, with the notation that the 
currently addressed record is either read or rewritten again as the 
sequential operation begins. You can also simply advance the random 
record position following each write to get the effect of a sequential 
write operation. Note that in particular, reading or writing the last 
record of an extent in random mode does not cause an automatic extent 
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^itch 
.0. 



as it does in sequential mode under either CP/M 1.4 or CP/M 



The error codes returned by a random write are identical to the 

andom read operation with the addition of error code 05, which 

idicates that a new extent cannot be created due to directory 
/erf low. 



Function 35: Compute File Size. 



When 
idresses 
resent) . 
le direc 
virtual'* 
icord fo 
inction 3 
iximum re 
)nstitute 
jfore) wh 



computing the size of a file, the DE regi 
an FC3 in random mode format (bytes r0, rl. 
The FCB contains an unambiguous file name which i 
tory scan. Upon return, the random record bytes c 
file size which is, in effect, the record addres 
llowing the end of the file. if, following 
5, the high record byte r2 is 01, then the file co 
cord count 65536 in version 2.0. Otherwise, bytes 

a 16-bit value (r0 is the least significant 
ich is the file size. 



ster pair 

and r2 are 

s used in 

ontain the 

s of the 

a call to 

ntains the 

r0 and rl 

byte, as 



Data can be appended to the end of an existing file by simply 
illing function 35 to set the random record position to the end of 
Lie, tnen performing a sequence of random writes starting at the 
:eset record address. 

The virtual size of a file corresponds to the physical size when 
le file is written sequentially. If, instead, the file was created 
1 random mode and "holes'* exist in the allocation, then the file may 
1 fact contain fewer records than the size indicates. If, for 
[ample, only the last record of an eight megabyte file is written in 
mdom mode (i.e., record number 65535), then the virtual size is 
)536 records, although only one block of data is actually allocated. 



Function 36: Set Random Record. 

The Set Random Record function causes the BDOS to automatically 
oduce the random record position from a file which has been read or 
itten sequentially to a particular point. The function can be 
jeful in two ways. 
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involved since the program need only store the buffer-relative byte 
position along with the key and record number in order to find the 
exact starting position of the keyed data at a later time. 

A second use of function 36 occurs when switching from a 
sequential read or write over to random read or write. A file is 
sequentially accessed to a particular point in the file, function 36 
is called which sets the record number, and subsequent random read and 
write operations continue from the selected point in the file. 



This section is concluded with a rather extensive, but complete 
example of random access operation. The program listed below performs 
the simple function of reading or writing random records upon command 
from the terminal. Given that the program has been created, 
assembled, and placed into a file labelled RAWD0M.COM, the CCP level 
command: 

RANDOM X.DAT 

Starts the test program. The program looks for a file by the name 
X.DAT (in this particular case) and, if found, proceeds to prompt the 
console for input. If not found, the file is created before the 
prompt is given. Each prompt takes the form 

next command? 



and is followed by operator input, terminated by a 
The input commands take the form 



carriage return. 



nW 



nR Q 



where n is an integer value in the range to 65535, and W, R, and C 
are simple command characters corresponding to random write, randon 
read, and quit processing, respectively. If the W command is issued, 
the RANDOM program issues the prompt 

type data: 

The operator then responds by typing up to 127 characters, followed b^ 
a carriage return. RANDOM then writes the character string into the 
X.DAT file at record n. If the R command is issued, RANDOM reads 
record number n and displays the string value at the console. If the 
Q command is issued, the X.DAT file is closed, and the program returns 
to the console command processor. In the interest of brevity (ok, sc 
the program's not so brief), the only error message is 

error, try again 

The program begins with an initialization section where th( 
input file is opened or created, followed by a continuous loop at the 
label '^ready" where the individual commands are interpreted. The 
default file control block at 005CH and the default buffer at 00801 
are used in all disk operations. The utility subroutines then follow, 
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which contain the principal input line processor, called "readc." 

This particular program shows the elements of random access 

processing, and can be used as the basis for further program 
development. 



0100 
0000 

0005 

0001 
0002 
0009 
000a 

000c 
000f 
0010 
0016 
0id21 
22 

005c 
7d 
007f 
0080 

000d 
000a 



0100 31bc0 



0103 0e0c 
0105 cd050 
0108 fe20 
010a d2160 

010d lllb0 
0110 cdda0 
0113 C3000 



. ********************** 
. * 

;* sample random access 
. * 

. ********************** 
org 100h 



0000h 
0005h 

1 

2 

9 

10 

12 

15 

16 

22 

33 

34 

005ch 
fcb+33 
fcb+35 
80h 

0dh 
0ah 



***************************** 

* 

program for cp/m 2.0 * 

* 

***************************** 
base of toa 



reboot 


equ 


bdos 

• 


egu 


coninp 


equ 


conout 


equ 


pstr ing 


equ 


rstring 


equ 


version 


equ 


openf 


equ 


closef 


equ 


makef 


equ 


raadr 


equ 


writer 

• 


eau 


fcb 


equ 


ranrec 


equ 


ranovf 


eq^ 


buff 

• 


equ 


cr 


equ 


If 


equ 



system reboot 
bdos entry point 

console input function 
console output function 
print string until '$* 
read console buffer 
return version number 
file open function 
close function 
make file function 
read random 
write random 

default file control block 
random record position 
high order (overflow) byte 
buffer address 

carriage return 
line feed 



i<i(i(iciciciii(iQicic'k-kic-kicicieicici('kiciciciiif'ki<'kicicicieici(l<icificic*i(icicic*'k-kicic 
* * 

* load S9 , set-up file for random access * 

i(icici(i(ici(iciKici(i(icici(i(i(ici(icic'ki«-kiiici:'kicii*ici(ic*icieific*'kicic'k'kicicicieicic 

Ixi sPrStack 

version 2.0? 

mvi c, version 

call bdos 

cpi 2j3h ;version 2.0 or better? 

jnc versok 

bad version, message and go back 

Ixi d^badver 

call print 

jmp reboot 



B 



versok ; 



correct version for random access 
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0116 


0e0f 


0118 


115C0 


011b 


cd050 


011e 


3c 


011f 


C2370 

• 
1 


0122 


• 

0el6 


0124 


115C0 


0127 


cd050 


012a 


3c 


012b 


C2370 

• 


ai2e 


• 
113a0 


0131 


cdda0 


0134 


c3000 



0137 cde50 
013a 227d0 
013d 217f0 
0140 3600 
0142 feSl 
0144 C2560 



0147 0el0 

0149 115C0 
014c cd050 
014f 3c 

0150 cab90 
0153 C3000 



mvi c^openf ;open default fcb 

Ixi d^fcb 

call bdos 

inr a ;err 255 becomes zero 

jnz ready 

cannot open file, so create it 

mvi c^makef 

Ixi d.fcb 

call bdos 

inr a ;err 255 becomes zero 

jnz ready 

cannot create file, directory full 

Ixi d^nospace 

call print 

jmp reboot ;back to ccp 

* * 

* loop back to "ready" after each command * 

* ****:»: *x** ******** ********************************* 



ready: 



file is ready for processing 

call readcom ;read next command 

snld ranrec ;store input record# 

Ixi h^ranovf 

mvi m,0 ;clear high byte if set 

cpi 'Q' ;quit? 

jnz notq 

quit processing, close file 

mvi c^closef 

Ixi d,fcb 

call bdos 

inr a ;err 255 becomes 

jz error ;error message, retry 

jmp reboot ;back to ccp 



* end of quit command, process write 
* 



0156 fe57 
0158 C2890 



015b 114d0 
015e cdda0 



*************************************************** 
* * 

* 
* 
*************************************************** 

notq: 

; not the quit command, random write? 

cpi 'W 

jnz notw 

; this is a random write, fill buffer until cr 
Ixi d,datmsg 
call print ;data prompt 
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0161 
0163 

0166 
0167 
0168 
016D 
016c 
016d 
016f 

0172 
0173 
0174 
0175 



0e7f 
21800 

c5 

e5 

cdc20 

el 

cl 

fe0d 

ca780 

77 
23 
0d 
C2660 



0178 3600 



017a 
017c 
017f 
0182 
0183 
0186 



0e22 

115C0 

cd050 

b7 

c2b90 

C3370 



0189 fe52 
018b c2b90 



018e 0e21 

0190 115C0 

0193 cd050 

019 6 b7 

0197 c2b90 



019a cdcf0 
019d 0e80 
019f 21800 

01a2 7e 
01a3 23 
01a4 e67f 
01a6 ca370 
01a9 c5 
01aa e5 



rloop: 



erloop: 



mvi 

Ixi 

; read 

pusn 

push 

call 

pop 

pop 

cpi 

jz 
not 

mov 
inx 
dcr 
jnz 



n 



end 



c,127 

h /DU f f 
ext cha 

b 

h 

getchr 

h 

b 

cr 

erloop 
, store 

m,a 

h 

c 

rloop 



;up to 127 characters 
;destination 
racter to buff 
;save counter 
;next destination 
;character to a 
;restore counter 
;restore next to fill 
;end of line? 

character 

;next to fill 
;counter goes down 
;end of Duffer? 



end of read loop, store 00 
mvi m^S 



write 

mvi 

Ixi 

call 

ora 

jnz 

jmp 



the record 
c, writer 
d.fcb 
bdos 
a 

error 
ready 



to selected record number 



;error code zero? 
;message if not 
;for another record 



^ end of write command, process read 



i(i(iii(i<i<i(i(i(i(iii(iii(±ifiti<i(i(i(i(i«i(i(i<i(iii(ici(icicif-k'kic'k'k'k'k'k'k'k-k'k'k'kicieic 
■k * 

icieicifi(i(i(icieici(icicici(icici(*icicicicicicicieieicicicieicicicieici<icicici(icific'kiei<icicic 

notw: 

; not a write command, read record? 

cpi 'R' 

jnz error ;skip if not 

■ 

; read random record 
mvi creadr 
Ixi d,fcb 
call bdos 

ora a ;return code 00? 
jnz error 

; read was successful, write to console 
call crlf ;new line 

;max 128 characters 
h,buff ;next to get 






wloop: 



mvi 


c,12a 


Ixi 


h,buf 


mov 


a,m 


inx 


h 


ani 


7fh 


jz 


ready 


push 


b 


DUSh 


h 



;next character 

;next to get 

;mask parity 

;for another command if 00 

;save counter 

;save next to get 
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;graphic? 

;skip output if not 



;count=count-l 



icifificiei(iciei(i(icicieici<ici(iciciei(icici(i<ici(icici(icicicicicicici('kicicicicicici(i<i(icici( 

* end of read command, all errors end-uo here * 



01ab 


fe20 


cpi 




01ad 


d4c80 


cnc 


putchr 


01b0 


el 


pop 


h 


01bl 


cl 


pop 


b 


01b2 


0d 


dcr 


c 


01b3 


c2a20 


jnz 


wloop 


01b6 


C3370 


jmp 


ready 



error: 



0159 11590 
01bc cdda0 
01bf C3370 



Ixi 

call 

jmp 



d^errmsg 

print 

ready 



:^ ******:*********:^ *******************!»:** :it *********** 



* utility subroutines for console i/o 



qetchr : 



01c2 0e01 
01c4 cd050 
01c7 c9 



01c8 0e02 
01ca 5f 
01cb cd050 
01ce c9 



putchr : 



;read next console character to a 

mvi c^coninp 

call bdos 
ret 



;write character from a to console 

mvi c^conout 

mov e^a ;character to send 

call bdos ;send character 

ret 



crlf 



01cf 3e0d 

01dl cdc80 

01d4 3e0a 

01d6 cdc80 

01d9 c9 



01da d5 
01db cdcf0 
01de dl 
01df 0e09 
01el cd050 
01e4 c9 



print: 



;send carriage return line feed 

mvi a,cr ;carriage return 

call putchr 

mvi a, If ;line feed 

call putchr 

ret 



;print the buffer addressed by de until $ 

push d 

call crlf 

pop d ;new line 

mvi c/pstring 

call bdos ;print the string 

ret 



readcom: 
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01e5 
01e8 
01eb 
01ed 
01f0 

01f3 
01f6 
01f9 
01fa 
01fb 
01fc 

01fd 
01ff 
0201 

0204 
0205 
0206 
0207 
0208 
0209 
020a 

02i3O 

020c 
020f 
0210 



0213 
0215 
0217 

0218 
021a 



116b0 

cdda0 

0e0a 

117a0 

cd050 

21000 

117C0 

la 

13 

b7 

c8 

d630 
fe0a 
d2130 

29 

4d 

44 

29 

29 

09 

85 

&r 

d2f90 

24 

c3f90 



c630 
fe61 
dS 

e65f 
c9 



reaac; 



endrd; 



;read the next command line to the conbuf 

Ixi d, prompt 

call print ; command? 

mvi c,rstring 

Ixi d, conbuf 

call bdos ;read command line 

command line is present, scan it 

Ixi h,0 ;start with 0000 

Ixi d,conlin;command line 

Idax d ;next command character 

inx d ;to next command position 

ora a ; cannot be end of command 

rz 

not zero, numeric? 

sui '0' 

cpi 10 rcarry if numeric 

jnc endrd 

add-in next digit 



dad 
raov 
mov 
dad 
dad 
dad 
add 
mov 
jnc 
inr 
jmp 



h 

c,l 

b,h 

h 

h 

b 

1 

l,a 

readc 

h 

readc 



;bc = value * 2 

;*4 

;*8 

•*2 + *8 = *10 

;+digit 

;for another char 

; overflow 

;for another char 



021b 
023a 
024d 
0259 
026D 



end of read, restore value in a 

adi '0* ; command 

cpi 'a' jtranslate case? 

re 

lower case, mask lower case bits 

ani 101$llllb 

ret 

*************************************************** 

* * 

* string data area for console messages * 

* * 

*************************************************** 

badver : 

'sorry, you need cp/m version 2$' 



Append! 
C 



536f79 db 

nospace: 
4e6f29 db 

datmsg : 
547970 db 

errmsg : 
457272 db 

prompt: 
4e6570 db 



'no directory space$' 
' type data: $* 
'error, try again. $' 
'next command? $' 
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027a 


21 


conbuf : 


db 


027b 




consiz: 


ds 


027c 




conlin: 


ds 


0021 


= 


conlen 


equ 


29c 




stack: 


ds 


2bc 






end 



i<icicicicicieificicici(icicici(iei(icicicici(ifi<ifi(ici(icicicici(icisici(i(icici(icicici:i(ic'kisi( 
* * 

* fixed and variable data area * 

* * 

i(ic*i<icicicici(i(ici(icieicicicicicici(ificiei(icicicici<iciciciciei(icifi(^cicici(ieic'kicificici( 

conlen ;length of console buffer 
1 ; resulting size after read 
32 ;length 32 buffer 
$-consiz 



32 



;16 level stack 
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9. CP/M 2.0 MEMORY ORGAlSIIZATION. 

Similar to earlier versions^ CP/M 2.0 is 



field-altered 
host computer 



to fit 
various memory sizes, depending upon the host computer memory 
configuration. Typical base addresses for popular memory sizes are 
shown in the table below. 



Module 


20k 


24k 


32k 


48k 


64k 


CCP 


3400H 


4400H 


6400H 


A400H 


E400H 


BDOS 


3C00H 


4C00H 


6C00H 


AC00H 


EC00H 


BIOS 


4A00H 


5A0 0H 


7A00H 


BA00H 


FA0 0H 


Tod of Ram 


4FFFH 


5FFFH 


7FFFH 


BFFFH 


FFFFH 



The distribution disk contains a CP/M 2.0 system configured for a 20k 
Intel MDS-800 with standard IBM 8" floppy disk drives. The disk 
layout is shown below: 



Sector 


Track 


00 


Module 


Track 


01 


b 


loduli 


1 


(Bootstrap Loader) 


4080H 


BDOS 


+ 


480H 


2 


3400H 


CCP 


+ 


0H 


4100H 


BDOS 


+ 


500H 


3 


3480H 


CCP 


+ 


080H 


4180H 


BDOS 


+ 


580H 


4 


3500H 


CCP 


+ 


100H 


4200H 


BDOS 


+ 


600H 


5 


3580H 


CCP 


+ 


180H 


4280H 


BDOS 


+ 


680a 


6 


3600H 


CCP 


+ 


200H 


4300H 


BDOS 


+ 


700H 


7 


3680H 


CCP 


+ 


280H 


4 380H 


BDOS 


+ 


780H 


a 


3 700H 


CCP 


+ 


300H 


4400H 


BDOS 


+ 


800H 


y 


3780H 


CCP 


+ 


3 8 0H 


4480H 


BDOS 


+ 


880H 


10 


3800H 


CCP 


+ 


400H 


4500H 


BDOS 


+ 


900H 


11 


3880H 


CCP 


+ 


480H 


4580H 


BDOS 


+ 


980H 


12 


3900H 


CCP 


+ 


500H 


4600H 


BDOS 


+ 


A00H 


13 


3980H 


CCP 


+ 


580H 


4680H 


BDOS 


+ 


A80H 


14 


3A00H 


CCP 


+ 


600H 


4700H 


BDOS 


+ 


B00H 


15 


3A80H 


CCP 


+ 


680H 


4780H 


BDOS 


+ 


B80H 


16 


3B00H 


CCP 


+ 


70 0H 


4800H 


BDOS 


+ 


C00H 


17 


3B80H 


CCP 


+ 


780H 


4880H 


BDOS 


+ 


C80H 


18 


3C00H 


BDOS 


+ 


000B 


4900H 


BDOS 


+ 


D00H 


19 


3C80H 


BDOS 


+ 


080H 


4980H 


BDOS 


+ 


D80H 


20 


3D00H 


BDOS 


+ 


100H 


4A00H 


BIOS 


+ 


000H 


21 


3D80H 


BDOS 


+ 


180H 


4A80H 


BIOS 


+ 


080H 


22 


3E00H 


BDOS 


+ 


200H 


4600H 


BIOS 


+ 


100H 


23 


3E80H 


BDOS 


+ 


280H 


4B80H 


BIOS 


+ 


180H 


24 


3F00H 


BDOS 


+ 


300H 


4C00H 


BIOS 


+ 


200H 


25 


3F80H 


BDOS 


+ 


380H 


4C80H 


BIOS 


+ 


280H 


26 


4000H 


BDOS 


+ 


400H 


4D00H 


BIOS 


+ 


300H 



^^^ 



In particular, note that the CCP is at the same position on the disk, 
and occupies the same space as version 1.4. The BDOS portion, 
however, occupies one more 256-byte page and the BIOS portion extends 
through the remainder of track 01. Thus, the CCP is 800H (2048 
decimal) bytes in length, the BDOS is E00H (3584 decimal) bytes in 
length, and the BIOS is up to 380H (898 decimal) bytes in length. In 
version 2.0, the BIOS portion contains the standard subroutines of 
1.4, along with some initialized table space, as described in the 
following section. 
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10. 3103 DIFFERENCES. 

The CP/M 2.0 Basic I/O System differs only slightly in concept 
from its predecesssors. Two new jump vector entry points are defined, 
a new sector translation subroutine is included, and a disk 
characteristics table must be defined. The skeletal form of these 
changes are found in the program shown below. 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 



bpb 
rpb 
maxb 



boot: 

9 

listst! 
seldsk: 



org 4000xh 

maclio diskdef 

jmp boot 

• • • 

jmp listst ;list status 

jmp sectran ;sector translate 

disks 4 

large capacity drive 



selsec: 



equ 

equ 

equ 

d i s kd e f 

diskdef 

diskdef 

disKdef 

ret 

xra 

ret 



16*1024 ;bytes per block 
bpb/128 ; records per block 
65535/rpb ;max block number 
, 1 , 58 , 3 r bpb ,maxb+l ,128,0,2 
1,1,58, ,bpb,maxb+l,128,0,2 
2,0 
3.1 



/•nop 



;nop 



;driv( 

Ixi 

mov 

cpi 

rnc 

propel 

mov 

dad 

dad 

dad 

dad 

Ixi 

dad 

ret 



number 
h,0 
a,c 
ndisks 



m 



disk 

IrC 

h 
h 
h 
h 



c 

;0000 in hi produces 
;a is disk number .. 
;less than ndisks? 
;return with HL = 0000 
number, return dpb element 

;*2 

;*4 
;*8 
;*16 



select error 
.• ndisks-1 



if not 
address 



d,dpbase 



;HL=.dpb 



sectran: 



; sector number in c 

Ixi h, sector 

mov m,c 
ret 



; translate sector BC, using table at DE 

xchg ;HL = .tran 

dad b ;single precision tran 
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48; 



49: 




mov l,m 


50: 


• 


fill botn H 


51: 




ret 


52: 


• 




53: 


sector: 


ds 1 


54: 




endef 


55: 




end 



dad b again if double precision tran 

;onlY iow byte necessary here 
and L if double precision tran 
;HL = ??ss 



Referring to the program shown above, lines 3-6 represent the 
BIOS entry vector of 17 elements (version 1.4 defines only 15 jump 
vector elements) . The last two elements provide access to the 
"LISTST" (List Status) entry point for DESPOOL. The use of this 
particular entry point is defined in the DESPOOL documentation, and is 
no different tnan the previous 1.4 release. It should be noted that 
tne 1.4 DESPOOL urogram will not operate under version 2.0, but an 
update version will be available from Digital Research in the near 
future. 



The "SECTRAN" (Sector Number Translate) entry shown in the jump 
vector at line 6 provides access to a BIOS-resident sector translation 
subroutine. This mechanism allows the user to specify the sector skew 
factor and translation for a particular disk system, and is described 
below. 

A macro library is shown in the listing,, called DISKDEF, 
included on line 2, and referenced in 12-15. Although it is not 
necessary to use the macro liorary, it greatly simplifies the disk 
definition process. You must have access to the MAC macro assembler, 
of course, to use the DISKDEF facility, while the macro library is 
included with all CP/M 2.0 distribution disks. (See the CP/M 2.0 
Alteration Guide for formulas which you can use to hand-code the 
tables produced by the DISKDEF library) . 



A BIOS disk definition consists 
macro statements: 



of the following sequence of 



M ACL 13 

DISKS 

DISKDEF 

DISKDEF 



DISKDEF 

n 
0.. .. 



DISKDEF n-1 



ENDEF 



where the MACLIB statement loads the DISKDEF. LIB file (on the same 
disk as your BIOS) into MAC's internal tables. The DISKS macro call 
follows, which specifies the number of drives to be configured with 
your system, where n is an integer in the range 1 to 16. A series of 
DISKDEF macro calls then follow which define the characteristics of 
each logical disk, through n-1 (corresponding to logical drives A 
through P) . Note that the DISKS and DISKDEF macros generate in-line 
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fixed data tables, and tnus must be placed in a non-executable portion 
of your BIOS, typically directly following the BIOS jump vector. 

The remaining portion of your SIOS is defined following the 
DISKDEF macros, with the ENDEF macro call immediately preceding the 
END statement. The SNDEF (End of Diskdef) macro generates the 
necessary uninitialized RAM areas which are located above your BIOS. 

The form of the DISKDEF macro call is 

DISKDEF dn,fsc,lsc, [skf] ,bls ,dks,dir , cks, of s, [0] 

where 

dn is the logical disk number, to n-1 

fsc is the first physical sector number (0 or 1) 

Isc is the last sector number 

skf is the optional sector skew factor 

bis is the data allocation block size 

dir is the number of directory entries 

cks is the number of "checked" directory entries 

of s is the track offset to logical track 00 

[0] is an optional 1.4 compatibility flag 

The value "dn" is the drive number being defined v/ith this DISKDEF 
macro invocation. The "fsc" parameter accounts for differing sector 
numbering systems, and is usually or 1. The "Isc" is the last 
numbered sector on a track. When present, the "skf" parameter defines 
the sector skew factor which is used to create a sector translation 
table according to the skew. If the number of sectors is less than 
256, a single-byte table is created, otherwise each translation table 
element occupies two bytes. No translation table is created if the 
skf parameter is omitted (or equal to 0). The "bis" parameter 
specifies the number of bytes allocated to each data block, and takes 
on the values 1024, 2048, 4096, 8192, or 16384. Generally, 
performance increases with larger data block sizes since there are 
fewer directory references and logically connected data records are 
physically close on the disk. Further, each directory entry addresses 
more data and the BIOS-resident ram space is reduced. The "dks" 
specifies the total disk size in "bis" units. That is, if the bis 
2048 and dks = 1000, tnen the total disk capacity is 2,048,000 bytes. 
If dks is greater than 255, then the block size parameter bis must be 
greater than 1024. The value of "dir" is the total number of 
directory entries which may exceed 255, if desired. The "cks" 
parameter determines the number of directory items to check on each 
directory scan, and is used internally to detect changed disks during 
system operation, where an intervening cold or warm start has not 
occurred (when this situation is detected, CP/M automatically marks 
the disk read/only so that data is not subsequently destroyed) . 
Normally the value of cks = dir when the media is easily changed, as 
is the case with a floppy disk subsystem. If the disk is permanently 
mounted, then the value of cks is typically 0, since the probabilitv 
of cnanging disks without a restart is quite low. The "ofs" value 
determines the number of tracks to* skip when this particular drive is 
addressed, which can be used to reserve additional operating systeir 
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space or to simulate several logical drives on a single large capacity 
physical drive. Finally, the [0] parameter is included when file 
compatibility is required with versions of 1.4 which have been 
modified for higher density disks. This parameter ensures that only 
16K is allocated for each directory record, as was the case for 
previous versions. Normally, this parameter is not included. 



For convenience and economy of table space, the special fo 



rm 



DI3KDEF 



IrD 



gives disk i the same characteristics as a previously defined drive j. 
A standard four-drive single density system, which is compatible with 
version 1.4, is defined using the following macro invocations: 



DISKS 
DISKDEF 
DISKDEF 
DISKDEF 
DISKDEF 



0,1,26,6,1024,243,64,64,2 

2,0 
3.0 



ENDEF 

with all disKs having the same parameter values of 26 sectors per 
track (numbered 1 through 26) , with 6 sectors skipped between each 
access, 1024 bytes per data block, 243 data blocks for a total of 243k 
byte disk capacity, 64 checked directory entries, and two operating 
system tracks. 

The definitions given in the program shown above (lines 12 
through 15) provide access to the largest disks addressable by CP/M 
2.0. All disks have identical parameters, except that drives and 2 
skip three sectors on every data access, while disks 1 and 3 access 
each sector in sequence as the disk revolves (there may, however, be a 
transparent hardware skew factor on these drives) . 

The DISKS macro generates n "disk header blocks," starting at 
address DPBASE which is a label generated by the macro. Each disk 
header block contains sixteen bytes, and correspond, in sequence, to 
each of the defined drives. In the four drive standard system, for 
example, the DISKS macro generates a table of the form: 




DPBASE 

DPE0: 

DPEl: 

DPE2: 

DPE3: 



EQU 

DW 

DW 

DW 

DW 



V 

XLT0 ,0 000H,0 00H,0 00H,DIRBUF,DPB0,CSV0,ALV0 
XLT0,0 00H,0 00H,0 00H,DIRBUF,DPB0,CSV1,ALV1 
XLT0,0 000H,00 00H,0000H,DIRBUF,DPB0,CSV2,ALV2 
XLT0,0 00H,00 00H,0 00H,DIRBUF,DPB0,CSV3,ALV3 



where the DPE (disk parameter entry) labels are included for reference 
purposes to show the beginning table addresses for each drive 
through 3. The values contained within the disk parameter header are 
described in detail in the CP/M 2.0 Alteration Guide, but basically 
address the translation vector for the drive (all reference XLT0 , 
which is the translation vector for drive in the above example) , 
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followed by three 16-bit "scratch" addresses, followed by the 
directory buffer address, disk parameter block address, check vector 
address, and allocation vector address. The check and allocation 
vector addresses are generated by the ENDEF macro in the ram area 
following the BIOS code and tables. 

The SELDSK function is extended somewhat in version 2.0. In 
particular, the selected disk number is passed to the BIOS in register 
C, as before, and the SELDSK subroutine performs the appropriate 
software or hardware actions to select the disk. Version 2.0, 
however, also requires the SELDSK subroutine to return the address of 
the selected disk parameter header (DPE0, DPEl , DPE2, or DPE3, in the 
above example) in register HL. If SELDSK returns the value HL = 
0000H, then the BDOS assumes the disk does not exist, and prints a 
select error mesage at the terminal. Program lines 22 through 36 give 
a sample CP/M 2.0 SELDSK subroutine, showing only the disk parameter 
header address calculation. 

The subroutine SECTRAN is also included in version 2.0 which 
performs the actual logical to physical sector translation. In 
earlier versions of CP/M, the sector translation process was a part of 
the BDOS, and set to skip six sectors between eacn read. Due 
differing rotational speeds of various disks, the translation function 
has become a part oJE the BIOS in version 2.0. Thus, the BDOS sends 
sequential sector numbers to SECTRAN, starting at sector number 0. 
The SECTRAN subroutine uses the sequential sector number to produce a 
translated sector number which is returned to the BDOS. The BDOS 
subsequently sends the translated sector number to SELSEC before the 
actual read or write is performed. Note that many controllers have 
the capability to record the sector skew on the disk itself, and thus 
there is no translation necessary. In this case, the "skf" parameter 
is omitted in the macro call, and SECTRAN simply returns the same 
value which it receives. The table shown below, for example, is 
constructed when the standard skew factor skf = 6 is specified in the 
DISKDEF macro call: 

XLT0: DB 1,7,13,19,25,5,11,17,23,3,9,15,21 
DB 2,8,14,20,26,6,12,18,24,4,10,16,22 

If SECTRAN is required to translate a sector, then the following 
process takes place. The sector to translate is received in register 
pair BC. Only the C register is significant if the sector value does 
not exceed 255 (B = 00 in this case). Register pair DE addresses the 
sector translate table for this drive, determined by a previous call 
on SELDSK, corresponding to the first element of a disk parameter 
header (XLT0 in the case shown above) . The SECTRAN subroutine then 
fetches the translated sector number by adding the input sector number 
to the base of the translate taole, to get the indexed translate table 
address (see lines 46, 47, and 48 in the above program). The value at 
this location is then returned in register L. Note that if the number 
of sectors exceeds 255, the translate table contains 16-bit elements 
whose value must be returned in HL. 

Following the ENDEF macro call, a number of uninitialized data 
areas are defined. These data areas need not be a part of the BIOS 
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which is loaded upon cold start, but must be available between the 
3I0S and the end of memory. The size of the uninitialized RAM area is 
determined by EQU statements generated by the ENDEF macro. For a 
standard four-drive system, the ENDEF macro miqht oroduce 



4C72 = 

4DB0 = 
013C = 



BEG DAT EQU ? 
(data areas) 
ENDDAT EQU $ 
DAT3IZ EQU $-BEGDAT 



which indicates that uninitialized RAM begins at location 4C72H, ends 
at 4DB0H-1, and occupies 013CH bytes. You must ensure that these 
addresses are free for use after the system is loaded. 

CP/M 2.0 is also easily adapated to disk subsystems whose sector 
size is a multiple of 128 bytes. Information is provided by the BDOS 
on sector write operations whicn eliminates the need for pre-read 
operations, thus allowing olocking and deblocking to take place at the 
BIOS level. 

See the "CP/M 2.0 Alteration Guide" for additional details 
concerning tailoring your CP/M system to your particular hardware. 



Append! 
C 
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APPENDIX D 



OPERATION OF 
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CP/M Dynamic Debugging Tool (DDT) 
User's Guide 



I. Introduction, 

The DDT program allows dynamic interactive testing and debugging of 
programs generated in the CP/M environment. The debugger is initiated by 
typing one of the following commands at the CP/M Console Command level 

DDT 

DDT filename. HEX 

DDT filename.COM 

where "filename" is the name of the program to be loaded and tested. In both 
cases, the DDT program is brought into main memory in the place of the Console 
Command Processor (refer to the CP/M Interface Guide for standard memory 
organization) , and thus resides directly below the Basic Disk Operating System 
portion of CP/M. The BDOS starting address, which is located in the address 
field of the JMP instruction at location 5H, is altered to reflect the reduced 
Transient Program Area size. 

The second and third forms of the DDT command shown above perform the same 
actions as the first, except there is a subsequent automatic load of the 
specified HEX or COM file. The action is identical to the sequence of 
commands 

DDT 

Ifilename.HEX or Ifilename.COM 

R 

where the I and R commands set up and read the specified program to test (see 
the explanation of the I and R commands below for exact details) . 

Upon initiation, DDT' prints a sign-on message in the format 

nnK DDr-s VER m.m 

where nn is the memory size (which must match the CP/M system being used) , s 
is the hardware system which is assumed, corresponding to the codes 

D - Digital Research standard version 

M - MDS version 

I - IMSAI standard version 

- Qmron systems 

S - Digital Systems standard version 

and m.m is the revision number. 
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Following the sign on iressage, DDT prompts the operator with the character 
"-" and waits for input commands from the console. The operator can type any 
of several single character commands^ terminated by a carriage return to 
execute the command. Each line of input can be line-edited using the standard 
CP/M controls 

rubout remove the last character typed 

ctl-U remove the entire line^ ready for re-typing 

ctl-C system reboot 

Any command can be up to 32 characters in length (an automatic carriage return 
is inserted as the 33rd character) , where the first character determines the 
command type 

A enter assembly language mnemonics with operands 

D display memory in hexadecimal and ASCII 

F fill memory with constant data 

G begin execution with optional breakpoints 

I set up a standard input file control block 

L list memory using assembler mnemonics 

M move a memory segment from source to destination 

R read program for subsequent testing 

S substitute memory values 

T trace program execution 

U untraced program monitoring 

X examine and optionally alter the CPU state 

The canmand character, in some cases, is followed by zero, one, two, or three 
hexadecimal values which are separated by commas or single blank characters. 
All OCT numeric output is in hexadecimal form. In all cases, the conmands are 
not executed until the carriage return is typed at the end of the command. 

At any point in the debug run, the operator can stop execution of DOT 
using either a ctl-C or G0 (jmp to location 0000H) , and save the current 
memory image using a SAVE command of the form 

SAVE n filename.COM 

where n is the number of pages (256 byte blocks) to be saved on disk. The 
number of blocks can be determined by taking the high order byte of the top 
load address and converting this nuntoer to decimal. For example, if the 
highest address in the Transient Program Area is 1234H then the number of 
pages is 12H, or 18 in decimal. Thus the operator could type a ctl-C during 
the debug run, returning to the Console Processor level, followed by 

SAVE 18 X.COM 

The memory image is saved as X.COM on the diskette, and can be directly 
executed by simply typing the name X. If further testing is required, the 
memory image can be recalled by typing 



DDT X.COM 

which reloads previously saved program fron loaction 100H through page 18 
(12FFH). The machine state is not a part of the COM file, and thus the 
program must be restarted from the beginning in order to properly test it. 

II. DDT COMMANDS. 

The individual commands are given below in some detail. In each case, the 
operator must wait for the prompt character (-) before entering the command. 
If control is passed to a program under test, and the program has not reached 
a breakpoint, control can be returned to DDT by executing a RST 7 from the 
front panel (note that the rubout key should be used instead if the program is 
executing a T or U command). In the explanation of each command, the command 
letter is shown in some cases with numbers separated by commas, v*iere the 
numbers are represented by lower case letters. These numbers are always 
assumed to be in a hexadecimal radix, and fron one to four digits in length 
(longer numbers will be automatically truncated on the right) . 

Many of the commands operate upon a "CPU state" which corresponds to the 
program under test. The CPU state holds the registers of the program being 
debugged, and initially contains zeroes for all registers and flags except for 
the program counter (P) and stack pointer (S) , viiich default to 100H. The 
program counter is subsequently set to the starting address given in the last 
record of a HEX file if a file of this form is loaded (see the I and R 
canmands) . 

1. The A (Assemble) Command. DDT allows inline assembly language to be 
inserted into the current memory image using the A command viiich takes the 
form 

As 

v*iere s is the hexadecimal starting address for the inline assembly. DDT 
prcxnpts the console with the address of the next instruction to fill, and 
reads the console, looking for assembly language mnemonics (see the Intel 8080 
Assembly Language Reference Card for a list of mnemonics) , followed by 
register references and operands in absolute hexadecimal form. Each sucessive 
load address is printed before reading the console. The A command terminates 
when the first empty line is input from the console. 

Upon completion of assembly language input, the operator can review the 
memory segment using the DDT disassembler (see the L command). 

Note that the assembler/disassembler portion of DDT can be overlayed by 

the transient program being tested, in v*iich case the DDT program responds 

with an error condition when the A and L commands are used (refer to Section 
IV). 
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2. The D (Display) Cominand, The D command allows the operator to view 
the contents of memory in hexadecimal and ASCII formats. The forms are 

D 

Ds 

Ds,f 

In the first case, memory is displayed fran the current display address 
(initially 100H) , and continues for 16 display lines. Each display line takes 
the form shown below 

aaaa bb bb bb bb bb bb bb bb bb bb bb bb bb bb bb bb cccccccccccccccc 

v*iere aaaa is the display address in hexadecimal, and bb represents data 
present in memory starting at aaaa. The ASCII characters starting at aaaa are 
given to the right (represented by the sequence of c's) , v*iere non-graphic 
characters are printed as a period (.) symbol. Note that both upper and lower 
case alphabetics are displayed, and thus will appear as upper case symbols on 
a console device that supports only upper case. Each display line gives the 
values of 16 bytes of data, except that the first line displayed is truncated 
so that the next line begins at an address v*iich is a multiple of 16. 

The second form of the D command shown above is similar to the first, 
except that the display address is first set to address s. The third form 
causes the display to continue from address s through address f. In all 
cases, the display address is set to the first address not displayed in this 
COTimand, so that a continuing display can be accomplished by issuing 
successive D commands with no explicit addresses. 

Excessively long displays can be aborted by pushing the rubout key. 



3, The F (Fill) Command. The F caranand takes the form 

Fs,f,c 

vdiere s is the starting address, f is the final address, and c is a 
hexadecimal byte constant. The effect is as follows: DDT stores the constant 
c at address s, increments the value of s and tests against f. If s exceeds f 
then the operation terminates, otherwise the cperation is repeated. Thus, the 
fill command can be used to set a memory block to a specific constant value. 

4. The G (Go) Canmand. Program execution is started using the G comand, 
with up to b70 optional breakpoint addresses. The G command takes one ot the 
forms 

G 

Gs 

Gs,b 



Gs,b,c 

G,b 

G,brC 

The first form starts execution of the program under test at the current value 
of the program counter in the current machine state, vd.th no breakpoints set 
(the only way to regain control in DDT is through a RST 7 execution) • The 
current program counter can be viewed by typing an X or XP command. The 
second form is similar to the first except that the program counter in the 
current machine state is set to address s before execution begins. The third 
form is the same as the second, except that program execution stops when 
address b is encountered (b must be in the area of the program under test) . 
The instruction at location b is not executed when the breakpoint is 
encountered. The fourth form is identical to the third, except that two 
breakpoints are specified, one at b and the other at c. Encountering either 
breakpoint causes execution to stop, and both breakpoints are subsequently 
cleared. The last tavo forms take the program counter from the current machine 
state, and set one and t;vo breakpoints, respectively. 

Execution continues from the starting address in real-time to the next 
breakpoint. That is, there is no intervention between the starting address 
and the break address by DDT. Thus, if the program under test does not reach 
a breakpoint, control cannot return to DIDT without executing a RST 7 
instruction. Upon encountering a breakpoint, DDT stops execution and types 

*d 

where d is the stop address. The machine state can be examined at this point 
using the X (Examine) cannmand. The operator must specify breakpoints v*iich 
differ from the program counter address at the beginning of the G command. 
Thus, if the current program counter is 1234H, then the commands 

G,1234 
and 

G400,400 

both produce an immediate breakpoint, without executing any instructions 
whatsoever. 



6. The I (Input) Command. The I command allows the cperator to insert a 
file name into the default file control block at 5CH (the file control block 
created by CP/M for transient programs is placed at this location; see the 
CP/M Interface Guide) . The default FCB can be used by the program under test 
as if it had been passed by the CP/M Console Processor. Note that this file 
name is also used by DDT for reading additional HEX and COM files. The form 
of the I command is 

Ifilename 
or 



If ilenaine .f iletype 

If the second form is used, and the filetype is either HEX or COM, then 
subsequent R commands can be used to read the pure binary or hex format 
machine code (see the R command for further details) • 

6. The L (List) Command. The L command is used to list assembly language 
mnenonics in a particular program region. The forms are 

L 

Ls 

Ls,f 

The first conmand lists twelve lines of disassembled machine code from the 
current list address. The second form sets the list address to s, and then 
lists tivelve lines of code. The last form lists disassembled code from s 
through address f. In all three cases, the list address is set to the next 
unlisted location in preparation for a subsequent L command. Upon 
encountering an execution breakpoint, the list address is set to the current 
value of the program counter (see the G and T conmands) . Again, long typeouts 
can be aborted using the rubout key during the list process. 

7. The M (Move) Command. The M cannmand allows block movement of program 
or data areas from one location to another in memory. The form is 

Ms,f,d 

where s is the start address of the mDve, f is the final address of the move, 

and d is the destination address. Data is first moved fran s to d, and both 

addresses are incremented. If s exceeds f then the wove operation stops, 
otherwise the wove operation is repeated. 

8. The R (Read) Command. The R command is used in conjunction with the I 
command to read COM and HEX files from the diskette into the transient program 
area in preparation for the debug run. The forms are 

R 
Rb 

v^ere b is an cptional bias address which is added to each program or data 
address as it is loaded. The load operation must not overwrite any of the 
system parameters fran 000H through 0FFH (i.e., the first page of memory). If 
b is emitted, then b=0000 is assumed. The R command requires a previous I 
command, specifying the name of a HEX or COM file. The load address for each 
record is obtained fran each individual HEX record, while an assumed load 
address of 100H is taken for COM files. Note that any number of R commands 
can be issued following the I command to re-read the program under test. 



assuming the tested program does not destroy the default area at 5CH, 
Further r any file specified with the filetype "COM" is assumed to contain 
machine code in pure binary form (created with the LOM) or SAVE command) , and 
all others are assumed to contain machine code in Intel hex format (produced^ 
for example r with the ASM command) . 

Recall that the command 

DDT filename. filetype 

which initiates the DDT program is equivalent to the commands 

DOr 

-If ilename. filetype 

-R 

Whenever the R ccxnmand is issued^ DDT responds with either the error indicator 
"?" (file cannot be opened, or a checksum error occurred in a HEX file), or 
with a load message taking the form 

NEXT PC 
nnnn pppp 

where nnnn is the next address following the loaded program, and pppp is the 
assumed program counter (100H for COM files, or taken fran the last record if 
a HEX file is specified) . 

9. The S (Set) Command. The S command allows memory locations to be 
examined and optionally altered. The form of the command is 

Ss 

where s is the hexadecimal starting address for examination and alteration of 
memory. DDT responds with a numeric prompt, giving the memory location, along 
with the data currently held in the memory location. If the operator types a 
carriage return, then the data is not altered. If a byte value is typed, then 
the value is stored at the prompted address. In either case, DDT continues to 
prompt with successive addresses and values until either a period (.) is typed 
by the operator, or an invalid input value is detected. 

10. The T (Trace) Command. The T command allows selective tracing of 
program execution for 1 to 65535 program steps. The forms are 

T 
Tn 

In the first case, the CPU state is displayed, and the next program step is 
executed. The program terminates immediately, with the termination address 



displayed as 

*hhhh 

where hhhh is the next address to execute. The display address (used in the D 
command ) is set to the value of H and L, and the list address (used in the L 
command) is set to hhhh. The CPU state at program termination can then be 
examined using the X connmand. 

The second form of the T command is similar to the first, except that 
execution is traced for n steps (n is a hexadecimal value) before a program 
breakpoint is occurs. A breakpoint can be forced in the trace mode by typing 
a rubout character. The CPU state is displayed before each program step is 
taken in trace mDde. The format of the display is the same as described in 
the X command. 

Note that program tracing is discontinued at the interface to CP/M, and 
resumes after return frati CP/M to the program under test. Thus, CP/M 
functions which access I/O devices, such as the diskette drive, run in 
real-time, avoiding I/O timing problems. Programs running in trace mode 
execute approximately 500 times slower than real time since DDT gets control 
after each user instruction is executed. Interrupt processing routines can be 
traced, but it must be noted that commands v*iich use the breakpoint facility 
(G, T, and U) accomplish the break using a RST 7 instruction, which means that 
the tested program cannot use this interrupt location. Further, the trace 
mode always runs the tested program with interrupts enabled, viiich may cause 
problems if asynchronous interrupts are received during tracing. 

Note also that the operator should use the rubout key to get control back 
to DDT during trace, rather than executing a RST 7, in order to ensure that 
the trace for the current instruction is completed before interruption. 

11. The U (Untrace) Command. The U command is identical to the T command 
except that intermediate program steps are not displayed. The untrace mDde 
allows fron 1 to 65535 (0FFFFH) steps to be executed in monitored mode, and is 
used principally to retain control of an executing program while it reaches 
steady state conditions. All conditions of the T command apply to the U 
command . 

12. The X (Examine) Command. The X command allows selective display and 
alteration of the current CPU state for the program under test. The forms are 

X 
Xr 

where r is one of the 8080 CPU registers 

C Carry Flag (0/1) 
Z Zero Flag (0/1) 



M Minus Flag (0/1) 

E Even Parity Flag (0/1) 

I Interdigit Carry (0/1) 

A Accumulator (0-FF) 

B BC register pair (0-FFFF) 

D DE register pair (0-FFFF) 

H HL register pair (0-FFFF) 

S Stack Pointer (0-FFFF) 

P Program Counter (0-FFFF) 

In the first case, the CPU register state is displayed in the format 

CfZfMfEflf A=bb B=dddd D=dddd H=dddd S=dddd P=dddd inst 

where f is a or 1 flag value, bb is a byte value, and dddd is a double byte 
quantity corresponding to the register pair. The "inst" field contains the 
disassembled instruction v*iich occurs at the location addressed by the CPU 
state's program counter. 

The second form allows display and optional alteration of register values, 
where r is one of the registers given above (C, Z, M, E, I, A, B, D, H, S, or 
P) . In each case, the flag or register value is first displayed at the 
console. The DDT program then accepts input from the console. If a carriage 
return is typed, then the flag or register value is not altered. If a value 
in the proper range is typed, then the flag or register value is altered. 
Note that BC, IE, and HL are displayed as register pairs. Thus, the operator 
types the entire register pair vdien B, C, or the BC pair is altered. 

III. IMPLEMENTATIOSf NOTES. 

The organization of DDT allows certain non-essential portions to be 
overlayed in order to gain a larger transient program area for debugging large 
programs. The DCT program consists of two parts: the DDT nucleus and the 
assembler/disassembler mDdule. The DDT nucleus is loaded over the Console 
Ccxnmand Processor, and, although loaded with the DDT nucleus, the 
assembler /disassembler is overlayable unless used to assemble or disassentole. 

In particular, the BDOS address at location 6H (address field of the JMP 
instruction at location 5H) is mDdified by DDT to address the base location of 
the DDT nucleus vhich, in turn, contains a JMP instruction to the BDOS. Thus, 
programs Which use this address field to size memory see the logical end of 
memory at the base of the DDT nucleus rather than the base of the BDOS. 

The assembler/disassembler module resides directly below the DDT nucleus 
in the transient program area. If the A, L, T, or X commands are used during 
the debugging process then the DDT program again alters the address field ^t 
6H to include this mDdule, thus further reducing the logical end of memory. 
If a program loads beyond the beginning of the assembler/disassembler mDdule, 
the A and L ccxnmands are lost (their use produces a "?" in response) , and the 




trace and display (T and X) comniands list the "inst" field of the display in 
hexadecimal, rather than as a decoded instruction. 

IV. AN EXAMPLE. 

The following example shows an edit, assemble, and debug for a sinple 
program v*iich reads a set of data values and determines the largest value in 
the set. The largest value is taken from the vector, and stored into "LARGE" 
at the termination of the program 



ED SCAN.ASM 



cU*<*^ 




LfL'^ART OF IRAN 



SIEMT AREA. 



iLENGTH OF VECTOR TO SCAN , 
i LARGER _RSJ VALUE SO FAR / 
H> VECT ;BASE OF VECTOR , 
GET VALUE j 



NFOUND: 



LARGER VALUE IN C ?, 



IF LARGER Vi 



•QUNS 



-■J 

VECT: 

LEH 
LARGE: 



*B9P 



LOOP: 



NFOUND; 



NEW LARGEST VALUE. STORE IT TO C 



HOV 
INK 
DCR 
JNZ 



H * 
LOOP 



TO NEKT ELEMENT, 



MORE TO SCAN? 
FOR AHOTHER j ^ 



END OF SCAN.. STORE C. 



MOV 
STA 
JMP 



A..C 
LARGE 
1 



;GET LARGEST VALUE. 



/REBOOT 









TEST DATA 



fthfVi,. 



f 



DB 
EQU 
DS 
END 



2 .. , 4, 3, 5, 6.. 1..5 , 

■■I . I >>d 

f,-VECT 



1 



jLENGTH .t> 

/LARGEST VALUE ON EXIT 



4, .^^^ 



ORG 
MVI 
MVl 
LXI 
MOV 
SUB 
JNC 
HEV 
MOV 
INK 
DCR 
JNZ 



100H 

B/LEH 

C/0 

H.. VECT 
A.. M 
C 

NFOUND 
LARGEST VALUE> 
C A 



START OF TRANSIENT AREA 
LENGTH OF VECTOR TO SCAN 
LARGEST VALUE SO FAR 
BASE OF VECTOR 
GET VALUE 

LARGER VALUE IN C? 
JUMP IF LARGER VALUE 
IT TO C 



NOT FOUND 



STORE 



H 
6 
LOOP 



TO NEXT 
MORE TO 



ELEMENT 
SCAN? 



FOR ANOTHER 



10 



END OF SCAN.. STORE C 

MOV A,. C ;GET LARGEST VALUE 

STA LARGE 

JMP e ;REBCiOT 

.! TEST DATA 

VECT: DB 2.. 0. 4.. 3, 5, 6.. 1. 5 

LEN EQU $-VECT ;LENGTH 

LARGE: DS 1 ;LARGEST VALUE ON EXIT 

END , 



ASM SCAN 



6W+ AsSewJftler 



CP/M ASSEMBLER 



VER 1.0 



8122 

602H USE FACTOR 

END OF ASSEMBLY 

TYPE SCAN. PRN 
^ 

0100 Uackwc Code. 

9100 0608 ; 

0102 0E00*'^ 

0104 211901 

0107 7E 

0108 91 

0109 D20D01 

010C 4F 

010D 23 

010E 05 

010F C20781 



A^sevAviu Cowpk-k ' lok c(\ ?ro?toy*v Ltej^i' 






g 



( 



5<JUfr£ ^(cgircm 



LOOP: 



NFOUHD 



nvij 



A> 



0112 79 

0113 322101 
0116 C30000 

Cck/iLlk llstlvi 

0119 0200840305VECT: 

0008 = <— ,,^ LEN 

0121 ]Ja\\ie(^ ] LARGE 

0i22 ^^j^-^ 



ORG 
MVI 
MVI 
LKI 
MOV 
SUB 
JNC 



180H 

B. LEN 

C, e 

H> VECX 
A, M 
C 
NFOUN.D 



START OF TRANSIENT AREA 

LENGTH OF VECTOR TO SCAN 

LARGEST VALUE SO FAR 

BASE OF VECTOR 

GET VALUE 

LARGER VALUE IN C? 

JUMP IF LARGER VALUE NOT FOUND 



NEW LARGEST VALUE.. STORE IT TO C 
MOV C A 

IHX H ;T0 NEXT ELEMENT 
DCR B .:MORE TO SCAN? 
JNZ LOOP ;FOR ANOTHER 

END OF SCAN. STORE C 



MOV 
STA 
JMP 


A.. C 
LARGE 




.iGET LARGEST VALUE 
.i REBOOT 


TEST 

DB 

EQU 

DS 

END 


DATA 

2. Q, 4.. 3. 

•I-VECT 

1 


. 5. 6. 1. 5 
; LENGTH 
J LARGEST VALUE ON EXIT 
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dut scan. hex 

i6K DDT VER 1. 
NEXT PC 



S-w Deloug^er [xj&yyv) kcx -fd/i/vwt m^cUm (At 



01 

-X 

cei 

-X 

p= 



21.8600 . I I I iJ • . 

^ * 4o £xeac{e of 

2erieE0i0 ^=00 6=0000 0=0000 h=0000 3=0100 P--0000 out 7f 

0000 100 ^, .ri I ../^ 



TC^o 



—I? U)c)^ dr ves\sys ^ciy<^ 



C:020MeE0I0 A = 60 B = 0000 D = e000 H = 0000 S = 0100 P 
- L 1 . 



01 

01 

01 
01 
01 
01 
01 
01 
fl 
61 
01 

-L 

01 
01 
01 

6 1 

01 
01 
01 
01 
01 
01 
01 

-A 



00 

02 
04 
07 
08 
09 

0C 

0D 
0E 
0F 
12 

V 

13 
16 
19 
lA 
IB 
IC 
ID 
IE 
20 
21 
24 

lie 



MVI 
MVI 
LXI 
MOV 
SUB 
JNC 
MOV 
INX 
DCR 
JNZ 
MOV 



B. es 

C. 00 

H .. 1 1 9 
A.. M 
C 

ei0D 

C. A 

H 

B 

0107 

A. C 



^ 



= 0100 MVI B.0S*^ 



J 



Code a-t loon . 



ST A 

J MP 

STAX 

NOP 

IMP. 

INX 

DCR 

MVI 

DCR 

LXI 

LXI 



0121 

0000 

B 



1 

2200 

20 



1 

1 
■L 



16 RST 



01 17 



113 



01 
1 



13 
16 



STA 
RST 



(A lAeWLOYC 
modi me Gxle 
e\Ack.Qi bcocfoA lit 

ull cmL 4V. p^ogvanA unde/ -ij-sV 4c> YfWwv. 4o DITT it ^itH 

cafn<yc yelufK e-^ps a^semU^ mode) 
Coflt^ at HSU -k) dAot 4U! ^s^ 7 toas fY^orlji \xmM 
0121 _^iw?(^«cf^Mf 

7 ^-^ — 



f 2- 



0117 NOP 

0118 HOP 

0119 STAX 
011A NOP 
011EI INR 
eUC I NX 



-x.^ \x>(k iA vc3istrs 



-^. 



C0ZeM0E0I0 A=00 B=0009 D=0000 H=0000 8=0100 P-0100 MVI B, 08 

C0Z0M0E010 A = 00 8 = 6090 D = 0000 H = 0009 3 = 0100 P = 0100 MVI B.. 03*0102 

C0Z0M0E0I0 A = 00 B = 0800 11=0000 H = 0000 S=0100 P=9102 MVI C. 00*0104 

C0Z0M0E0I0 A=00 6=0800 D=B000 H=0000 S=0100 P=0104 LXI H. 0119*0107 

C:0Z0I10E0I0 A = 00 B = 0800 Ii = 0080 H = 0119 S = 0100 P=0107 MOV A.. M 

C0Z0M0E0I0 A=02 B=0800 D=0000 H=0119 S=0100 P=0108 SUB C 

C:0Z0M0E01_1 A = 02 B = 0800 D = 0000 H = 0119 S=0100 P = 0109 JNC 010D*010D 

01t9/gF T0 04 03~05 06 jfD '^'&'^o^'^^ >->^-— TJJiSr^rs --^^ 

0120V05/il 00 22 21 00 02 7E EB 77 13 2 3 EB 0B ^sJb 1 ..."!..". U. #. .f^. 

0130 C2 27 01 C3 03 29 00 00 00 00 B0 08 00 00 00 00 .■'...) 

0140 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 , . - . ^ j. . . . 

0150 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 UCm. }^. QWW^ ■ ■ ■ - 

0160 00 00 00 00 00 08 00 00 00 00 00 00 00 00 00 00 • IVl" ASSl tUt-Ur «''# ' ' 

0170 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 . '. ^ . t.- . f . . 

0180 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 A^'Tyl^ TP^*^?*^ ?t . . . 

0190 00 00 00 00 00 00 00 80 00 00 00 00 00 00 00 00 yU)y\ ^ fiVfCX^Wt- 

01 A0 00 00 00 00 00 00 00 00 08 00 00 00 00 00 00 00 ^luJ^iKifTS • • • • • - 

0180 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

01C0 00 00 00 00 00 00 00 80 00 00 00 00 00 00 00 00 

C:0Z0M0E0I1 A=02 6=0890 D=0000 H = 0119 S = 0100 P = 010D INK H 
- T 5 r 

-V 'Xfoce < <slcps \yom Caffeii CPU Skb 

C0Z0M9Eeil A=02 8=0800 D=0000 H=eil9 8=0100 P=010D INX H 

C:0Z0M0E0I1 A=02 B = 0800 D = 9000 H = 011A S = 0100 P = 010E BCR B AiJofiuM- 

C0Z0M0E0I1 A = 02 B = 0700 D = 0000 H = 01 lA 8 = 0190 P = 010F JNZ 1 7 -Sra* kpoiut 

C0Z0M0E0I1 A = 02 B = 0700 11=0000 H = 011A 8 = 0190 P = 0107 MOV A,M j 

C0Z0M0E0I1 A = 00 B = 0700 11 = 6000 H = 011A 8 = 0190 P = 0108 SUB C*0199/ 

C0Z1M0E1I1 A=00 B=0700 D=0600 H=011A 8=0199 P=0ie9 JNC 0ieD*0108 

C0Z0M0E1I1 A=04 B=0600 D=0000 H=011B 8=0198 P=9108 SUB C 
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CP/M Assembler User's Guide 

1. INTRDDUCTION. 

Ttie CP/M assembler reads assanbly language source files from the diskette, 
and produces 8080 machine language in Intel hex format. The CP/M assembler is 
initiated by typing 

ASM filename 
or 

ASM filename .parms 

In both cases, the assembler assumes there is a file on the diskette with the 
name 

filename .ASM 

vrtiich ccxitains an 8080 assembly language source file. The first and second 
forms shown above differ only in that the second form allows parameters to be 
passed to the assembler to control source file access and hex and print file 
destinations. 

In either case, the CP/M assembler loads, and prints the message 

CP/M ASSEMBLER VER n.n 

where n.n is the current version number. In the case of the first command, 
the assonbler reads the source file with assumed file type "ASM" and creates 
two output files 

filename. HEX 
and 

filename.PRN 

the "HEX" file contains the machine code corresponding to the original program 
in Intel hex format, and the "PRN" file contains an annotated listing showing 
generated machine code, error flags, and source lines. If errors occur during 
translation, they will be listed in the PRN file as well as at the console 

The second conmand form can be used to redirect input and output files 
from their defaults. In this case, the "parms" portion of the command is a 
three letter group which specifies the origin of the source file, the 
destination of the hex file, and the destination of the print file. The form 
is 

filename .plp2p3 

where pi, p2, and p3 are single letters 

pi: A,B, ..., Y designates the disk name which contains 



the source file 
p2: A,B, ...^ Y designates the disk name v^ich will re- 
ceive the hex file 
Z skips the generation of the hex file 

p3: A/B, ...^ Y designates the disk name vAiich will re- 
ceive the print file 
X places the listing at the console 

Z skips generation of the print file 

Thus, the comirand 

ASM X.AAA^ 

indicates that the source file (X.ASM) is to be taken from disk A, and that 
the hex (X.HEX) and print (X.PRN) files are to be created also on disk A, 
This forni of the command is implied if the assembler is run from disk A. That 
is, given that the operator is currently addressing disk A, the above command 
is equivalent to 

ASM X 

The command 

ASM X.ABX 

indicates that the source file is to be taken from disk A, the hex file is 
placed on disk B, and the listing file is to be sent to the console. The 
command 

ASM X.BZZ 

takes the source file from disk B, and skips the generation of the hex and 
print files (this command is useful for fast execution of the assembler to 
check program syntax) . 

The source program format is compatible with both the Intel 8080 assembler 
(macros are not currently implemented in the CP/M assembler, however) , as well 
as the Processor Technology Software Package #1 assembler. That is, the CP/M 
assembler accepts source programs written in either format. There are certain 
extensions in the CP/M assembler v\*iich make it somewhat easier to use. These 
extensions are described below. 

2. PROGRAM FORMAT. 

An assembly language program acceptable as input to the assembler consists 
of a sequence of statements of the form 

line# label operation operand ; comment 

v*iere any or all of the fields may be present in a particular instance. Each 



"'embly language statement is terminated with a carriage return and line feed 
(the line feed is inserted automatically by the ED program) , or with the 
character "!" which is a treated as an end-of-line by the assembler (thus, 
multiple assembly language statements can be written on the same physical line 
if separated by exclaim symbols) . 

The line# is an optional decimal integer value representing the source 
program line number, v^^ich is allowed on any source line to maintain 
compatibility with the Processor Technology format. In general, these line 
numbers will be inserted if a line-oriented editor is used to construct the 
original program, and thus ASM ignores this field if present. 

The label field takes the form 



or 



identifier 
identifier: 



and is optional, except where noted in particular statement types. The 
identifier is a sequence of alphanumeric characters (alphabetics and numbers) , 
where the first character is alphabetic. Identifiers can be freely used by 
the programmer to label elements such as program steps and assembler 
directives, but cannot exceed 16 characters in length. All characters are 
significant in. an identifier, except for the embedded dollar symbol ($) which 
can be used to improve readability of the name. Further, all lower case 
alphabetics become are treated as if they were ufper case. Note that the ":" 
following the identifier in a label is optional (to maintain compatibility 
between Intel and Processor Technology) . Thus, the following are all valid 
instances of labels 



X 


xy 


long$name 


x: 


yxl: 


longe r $named $da ta : 


X1Y2 


Xlx2 


x234$5678$9012$3456 



The operation field contains either an assembler directive, or pseudo 
operation, or an 8080 machine operation code. The pseudo operations and 
machine operation codes are described below. 

The operand field of the statement, in general, contains an expression 
formed out of constants and labels, along with arithmetic and logical 
operations on these elements. Again, the complete details of properly formed 
expressions are given below. 
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The conment field contains arbitrary characters following the ";" symbol 
until the next real or logical end-of-line. These characters are read, 
listed, and otherwise ignored by the assembler. In order to maintain 
compatability with the Processor Technology assembler, the CP/M assembler also 
treat statements v^iich begin with a "*" in column one as comment statements, 
which are listed and ignored in the assembly process. Note that the Processor 



Technology assenbler has the side effect in its operation of ignoring the 
characters after the operand field has been scanned. This causes an ainbiguous 
situation vjhen attempting to be compatible with Intel's language, since 
arbitrary expressions are allowed in this case. Hence, programs v*iich use 
this side effect to introduce conments, must be edited to place a ";" before 
these fields in order to assemble correctly. 

The assembly language program is formulated as a sequence of statements of 
the above form, terminated optionally by an END statement. All statements 
following the END are ignored by the assembler. 

3. FORMING THE OPERAND. 

In order to conpletely describe the operation codes and pseudo operations, 
it is necessary to first present the form of the operand field, since it is 
used in nearly all statements. Expressions in the operand field consist of 
simple operands (labels, constants, and reserved words) , combined in properly 
formed subexpressions by arithmetic and logical operators. The expression 
computation is carried out by the assenbler as the assembly proceeds. Each 
expression must produce a 16-bit value during the assembly. Further, the 
number of significant digits in the result must not exceed the intended use. 
That is, if an expression is to be used in a byte wove immediate instruction, 
then the most significant 8 bits of the expression must be zero. The 
restrictions on the expression significance is given with the individual 
instructions. 

3.1. Labels. 

As discussed above, a label is an identifier v^iich occurs on a particular 
statement. In general, the label is given a value determined by the type of 
statement \^*lich it precedes. If the label occurs on a statement v^iich 
generates machine code or reserves memory space (e.g, a ^OV instruction, or a 
DS pseudo operation) , then the label is given the value of the program address 
which it labels. If the label precedes an EQU or SET, then the label is given 
the value which results from evaluating the operand field. Except for the SET 
statement, an identifier can label only one statement. 

When a label appears in the operand field, its value is substituted by the 
assembler. This value can then be combined with other operands and operators 
to form the operand field for a particular instruction. 

3.2. Numeric Constants. 

A numeric constant is a 16-bit value in one of several bases. The base, 
called the radix of the constant, is denoted by a trailing radix indicator. 
The radix indicators are 

B binary constant (base 2) 
octal constant (base 8) 



Q octal constant (base 8) 

D decimal constant (base 10) 

H hexadecimal constant (base 16) 

is an alternate radix indicator for octal numbers since the letter is 
easily confused with the digit 0. Any numeric constant which does not 
terminate with a radix indicator is assumed to be a decimal constant, 

A constant is thus composed as a sequence of digits, followed by an 
optional radix indicator, vhere the digits are in the appropriate range for 
the radix. That is binary constants must be composed of and 1 digits, octal 
constants can contain digits in the range - 7, while decimal constants 
contain decimal digits. Hexadecimal constants contain decimal digits as well 
as hexadecimal digits A (10D) , B (IID) , C (12D) , D (13D) , E (14D) , and F 
(15D) . Note that the leading digit of a hexadecimal constant must be a 
decimal digit in order to avoid confusing a hexadecimal constant with an 
identifier (a leading will always suffice) . A constant composed in this 
manner must evaluate to a binary number v\^ich can be contained within a 16-bit 
counter, otherwise it is truncated on the right by the assembler. Similar to 
identifiers, imbedded "$" are allowed within constants to improve their 
readability. Finally, the radix indicator is translated to upper case if a 
lower case letter is encountered. The following are all valid instances of 
numeric constants 



1234 


1234D 


1100B 


1111$0000$1111$0000B 


1234H 


0FFEH 


33770 


33$77$22Q 


33770 


0fe3h 


1234d 


0ffffh 



3.3. Reserved Words. 

There are several reserved character sequences v^ich have predefined 
meanings in the operand field of a statement. The names of 8080 registers are 
given below, v\hich, when encountered, produce the value shown to the right 



A 


7 


B 





C 


1 


D 


2 


E 


3 


H 


4 


L 


5 


M 


6 


SP 


6 


PSW 


6 



^^ffi 



(again, lower case names have the same values as their upper case 
equivalents) . Machine instructions can also be used in the operand field, and 
evaluate to their internal codes. In the case of instructions v\^ich require 
operands, where the specific operand becomes a part of the binary bit pattern 



oPi-f7e instruction (e,g, IVDV A,B) , the value of the instruction (in this case 
IVDV) is the bit pattern of the instruction with zeroes in the optional fields 
(e,g, IVDV produces 40H) . 

ViBien the symbol "$" occurs in the operand field (not imbedded within 
identifiers and numeric constants) its value becomes the address of the next 
instruction to generate, not including the instruction contained wi thing the 
current logical line, 

3.4, String Constants. 

String constants represent sequences of ASCII characters, and are 
represented by enclosing the characters within apostrophe symbols (')• All 
strings must be fully contained within the. current physical line (thus 
allowing "!" symbols within strings), and must not exceed 64 characters in 
length. The apostrophe character itself can be included within a string by 
representing it as a double apostrophe (the two keystrokes ") , which becomes 
a single apostrophe vAien read by the assembler. In most cases, the string 
length is restricted to either one or two characters (the DB pseudo operation 
is an exception) , in vdnich case the string becomes an 8 or 16 bit value, 
respectively. Two character strings become a 16-bit constant, with the second 
character as the low order byte, and the first character as the high order 
byte. 

The value of a character is its corresponding ASCII code. There is no 
case translation within strings, and thus both upper and lower case characters 
can be represented. Note however, that only graphic (printing) ASCII 
characters are allowed within strings. Valid strings are 

A AB ab c 



'Walla Walla Wash. ' 

'She said "Hello" to me.' 

'I said "Hello" to her.' 

3.5. Arithmetic and Logical Operators. 

The operands described above can be combined in normal algebraic notation 
using any combination of properly formed operands, operators, and 
parenthesized expressions. The operators recognized in the operand field are 

a + b unsigned arithmetic sum of a and b 

a - b unsigned arithmetic difference between a and b 

+ b unary plus (produces b) 

- b unary minus (identical to - b) 

a * b unsigned magnitude multiplication of a and b 

a / b unsigned magnitude division of a by b 

a IVDD b remainder after a / b 

NOT b logical inverse of b (all 0's become I's, I's 

become 0's), viiere b is considered a 16-bit value 



a AND b bit-by-bit logical and of a and b 

a OR b bit-by-bit logical or of a and b 

a XOR b bit-by-bit logicl exclusive or of a and b 

a SHL b the value vAiich results from shifting a to the 

left by an amount b, with zero fill 
a SHR b the value which results from shifting a to the 

right by an amount b, with zero fill 

In each case^ a and b represent simple operands (labels, numeric 
constants, reserved words, and one or two character strings) , or fully 
enclosed parenthesized subexpressions such as 

10+20 10h+37Q LI /3 (L24-4) SHR 3 
('a' and 5fh) + '0' ('B'+B) OR (PSW+M) 
(l+(2+c)) shr (A-(B+1)) 

Note that all computations are performed at assembly time as 16-bit unsigned 
operations. Thus, -1 is computed as 0-1 which results in the value 0ffffh 
(i.e., all I's). The resulting expression must fit the operation code in 
which it is used. If, for example, the expression is used in a ADI (add 
immediate) instruction, then the high order eight bits of the expression must 
be zero. As a result, the operation "ADI -1" produces an error message (-1 
becomes 0ffffh v*iich cannot be represented as an 8 bit value) , v*iile "ADI (-1) 
AND 0FFH" is accepted by the assembler since the "AND" operation zeroes the 
high order bits of the expression. 

3.6. Precedence of Operators. 

As a convenience to the programmer, ASM assumes that operators have a 
relative precedence of application v^iich allows the programmer to write 
expressions without nested levels of parentheses. The resulting expression 
has assumed parentheses v*iich are defined by the relative precedence. The 
order of application of operators in unparenthesize expressions is listed 
below. Operators listed first have highest precedence (they are applied first 
in an unparenthesized expression) , v*iile operators listed last have lowest 
precedence. Operators listed on the same line have equal precedence, and are 
applied from left to right as they are encountered in an expression 

* / ^DD SHL SHR 

- + 

NOT 

AND 

OR XOR 

Thus, the expressions shown to the left below are interpreted by the assembler 
as the fully parenthesize expressions shown to the right below 

a*b + c (a*b)+c 

a + b*c a+(b*c) 

a NDD b * c SHL d ( (a MOD b) * c) SHL d 



a OR b AND NOT c + d SHL e a OR (b AND (NOT' (c + (d SHL e) ) ) ) 

Balanced parenthesized subexpressions can always be used to override the 
assumed parentheses^ and thus the last expression above could be rewritten to 
force application of operators in a different order as 

(a OR b) AND (NOT' c) + d SHL e 

resulting in the assumed parentheses 

(a OR b) AND ( (NOT c) + (d SHL e) ) 

Note that an inparenthesized expression is well-formed only if the expression 
which results fron inserting the assumed parentheses is well-formed, 

4. ASSEMBLER DIRECTIVES. 

Assembler directives are used to set labels to specific values during the 
assmbly, perform conditional assembly, define storage areas, and specify 
starting addresses in the program. Each assembler directive is denoted by a 
"pseudo cperation" which appears in the operation field of the line. The 
acceptable pseudo operations are 

ORG set the program or data origin 

END end program, optional start address 

EQU numeric "equate" 

SEP numeric "set" 

IF begin conditional assentoly 

ENDIF end of conditional assembly 

DB define data bytes 

DW define data words 

DS define data storage area 

The individual pseudo operations are detailed below 

4.1. The ORG directive. 

The ORG statement takes the form 

label ORG expression 

where "label" is an optional program label, and expression is a 16-bit 
expression, consisting of operands which are defined previous to the ORG 
statement. The assembler begins machine code generation at the location 
specified in the expression. There can be any nuirber of ORG statements within 
a particular program, and there are no checks to ensure that the programmer is 
not defining overlapping memory areas. Note that most programs written for 
the CP/M system begin with an ORG statement of the form 

ORG 100H 



which causes machine code generation to begin at the base of the CP/M 
transient program area. If a label is specified in the ORG statement^ then 
the label is given the value of the expression (this label can then be used in 
the operand field of other statements to represent this expression) • 

4.2. The END directive. 

The END statement is optional in an assembly language program, but if it 
is present it must be the last statement (all subsequent statements are 
ignored in the assembly) . The two forms of the END directive are 

label END 

label END expression 

v^iere the label is again optional. If the first form is used, the assembly 
process stops, and the default starting address of the program is taken as 
0000. Otherwise, the expression is evaluated, and becomes the program 
starting address (this starting address is included in the last record of the 
Intel formatted machine code "hex" file v^iich results from the assentoly) . 
Thus, most CP/M assembly language programs end with the statement 

END 100H 

resulting in the default starting address of 100H (beginning of the transient 
program area) . 

4.3. The EQU directive. 

The EQU (equate) statement is used to set up synonyms for particular 
numeric values, the form is 

label EOU expression 

where the label must be present, and must not label any other statement. The 
assembler evaluates the expression, and assigns this value to the identifier 
given in the label field. The identifier is usually a name which describes 
the value in a mDre human-oriented manner. Further, this name is used 
throughout the program to "parameterize" certain functions. Suppose for 
example, that data received from a Teletype appears on a particular input 
port, and data is sent to the Teletype through the next output port in 
sequence. The series of equate statements could be used to define these ports 
for a particular hardware environment 

TJYBPSE EQU 10H ;BASE PORT NUMBER FOR TTY 
TTYIN EQU TTYBASE ;TTy D?^TA IN 
TTYOUT EQU TTYBASE+1 ;TTY LATA OUT 

At a later point in the program, the statements v*iich access the Teletype 
could appear as 



IN TTYIN ;READ TTY MTA TO REG-A 

• • • 

our TTYOUT ;WRITE mTA TO TTY FROM REG-A 

making the program nore readable than if the absolute i/o ports had been 
used. Further, if the hardware environment is redefined to start the Teletype 
communications ports at 7FH instead of 10H, the first statement need only be 
changed to 

TTOBASE EQU 7FH ;BASE PORT NUMBER FOR TTY 

and the program can be reassembled without changing any other statements, 

4.4. The SET Directive. 

The SET statement is similar to the EQU, taking the form 

label SET expression 

except that the label can occur on other SET statements within the program. 
The expression is evaluated and becomes the current value associated with the 
label. Thus, the EQU statement defines a label with a single value, viiile the 
SET statement defines a value which is valid from the current SET statement to 
the point where the label occurs on the next SET statement. The use of the 
SET is similar to the EQU statement, but is used mDSt often in controlling 
conditional assentoly. 

4.5. The IF and ENDIF directives. 

The IF and ENDIF statements define a range of assembly language statements 
which are to be included or excluded during the assentoly process. The form is 

IF expression 

statement#l 

statement#2 

. • • 
statement#n 
ENDIF 

Upon encountering the IF statement, the assembler evaluates the expression 
following the IF (all operands in the expression must be defined ahead of the 
IF statement). If the expression evaluates to a non-zero value, then 
statement#l through statement#n are assembled; if the expression evaluates to 
zero, then the statements are listed but not assembled. Conditional assentoly 
is often used to write a single "generic" program which includes a nuntoer of 
possible run-time environments, with only a few specific portions of the 
program selected for any particular assembly. The following program segments 
for example, might be part of a program which connmunicates with either a 
Teletype or a CRT console (but not both) • by selecting a particular value for 
TTY before the assembly begins 
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TOUC 


EQU 


0FFFFH 


FALSE 


EQU 


NOT TRIE 


i'iY 


EQU 


THJE 


TIYBASE 


EQU 


10H 


CKi'BASE 


EQU 


20H 




IF 


TiY 


OONIN 


EQU 


I'iYBASE 


OONOOT 


EQU 


T1YBASE+1 



ENDIF 

IF NCfT TTY 
OONIN EQU CRTBASE 
OONOOT EQU CRIBASE+1 

ENDIF 



;DEFINE VALUE OF TRUE 
;DEFINE VALUE OF FALSE 

;TRUE IF TTY, FALSE IF CRT 

BASE OF TTY I/O PORTS 
BASE OF CRT I/O PORTS 
ASSEMBLE RELATIVE TO TTYBASE 
CONSOLE INPOT 
CONSOLE OOTPOT 



ASSEMBLE RELATIVE TO CRTBASE 
CONSOLE INPOT , 
CONSOLE OOTPOT 



IN 



OOT 



OONIN 



CONOOT 



;READ CONSOLE LATA 
;WRITE CONSOLE DATA 



In tMs case^ the ptogram would assentDle for an environinent v^iere a Teletype 
is connected r based at port 10H. The statement defining TTY could be changed 
to 

TTY EQU FALSE 

andr in this case, the program would assemble for a CRT based at port 20H. 

4.6. The DB Directive. 

The DB directive allows the programmer to define initialize storage areas 
in single precision (byte) format. The statement form is 



label DB e#l, e#2. 



e#n 



v*iere e#l through e#n are either expressions \*iich evaluate to 8-bit values 
(the high order eight bits must be zero) , or are ASCII strings of length no 
greater than 64 characters. There is no practical restriction on the number 
of expressions included on a single source line. The expressions are 
evaluated and placed sequentially into the machine code file following the 
last program address generated by the assembler. String characters are 
similarly placed into memory starting with the first character and ending with 
the last character. Strings of length greater than two characters cannot be 
used as operands in more complicated expressions (i.e., they must stand alone 
between the commas) . Note that ASCII characters are always placed in memory 
with the parity bit reset (0). Further, recall that there is no translation 
from lower to upper case within strings. The optional label can be used to 
reference the data area throughout the rorainder of the program. Examples of 



■ 
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valid DB statements are 

data: DB 0,1,2,3,4,5 

DB data and 0ffh, 5, 3770r 1+2+3+4 

signon: DB 'please type your naine',cr ,lf ,0 

DB 'AB' SHR 8, 'C, 'DE' AND 7FH 

4.7. The DW Directive. 

The DW statement is similar to the DB statement except double precision 
(two byte) words of storage are initialized. The form is 

label DW e#l, e#2, ..., e#n 

vvhere e#l through e#n are expressions which evaluate to 16-bit results. Note 
that ASCII strings of length one or two characters are allowed, but strings 
longer than two characters disallowed. In all cases, the data storage is 
consistent with the 8080 processor: the least significant byte of the 
expression is stored forst in memory, followed by the most significant byte. 
Examples are 

doub: DW 0ffefh,doub+4,siqnon-$, 255+255 

DW 'a', 5, 'ab', 'CD', 6 shl 8 or lib 

4.8. The DS Directive. 

The DS statement is used to reserve an area of uninitialized memory, and 
takes the form 

label DS expression 

where the label is optional. The assembler begins subsequent code generation 
after the area reserved by the DS. Thus, the DS statement given above has 
exactly the same effect as the statement 

label: EQU $ ;LABEL VALUE IS CURRENT CODE LOCATION 
ORG $-fexpression ;MOVE PAST RESERVED AREA 

5. OPERATION CODES. 

Assembly language operation codes form the principal part of assembly 
language programs, and form the operation field of the instruction. In 
general, ASA accepts all the standard mnemonics for the Intel 8080 
microcomputer, \^hich are given in detail in the Intel manual "8080 Assembly 
Language Programminq Manual." Labels are optional on each input line and, if 
included, take the value of the instruction address immediately before the 
instruction is issued. The individual operators are listed breifly in the 
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following sections for completeness, although it is understood that the Intel 
manuals should be referenced for exact operator details. In each case, 



e3 

e8 
el6 



represents a 3-bit value in the range 0-7 
which can be one of the predefined registers 
A, B, C, D, E, H, L, M, SP, or PSW. 

represents an 8-bit value in the range 0-255 

represents a 16-bit value in the range 0-65535 



which can themselves be formed from an arbitrary canbination of operands and 
operators. In some cases, the operands are restricted to particular values 
within the allowable range, such as the PUSH instruction. These cases will be 
noted as they are encountered. 

In the sections vAiich follow, each operation codes is listed in its most 
general form, along with a specific example, with a short explanation and 
special restrictions. 

5.1. Jumps, Calls, and Returns, 

The Jump, Call, and Return instructions allow several different forms 
which test the condition flags set in the 8080 microcomputer CPU, The forms 
are 



JMP el6 

JNZ el6 

JZ el6 

JNC el 6 

JC el6 

JPO el6 

JH; el6 

JP el6 

JM el6 

CALL el 6 

CNZ el6 

CZ el6 

CNC el6 

CC el6 

CPO el6 

CPE el6 

CP el6 

CM el6 

RST e3 



JMP LI 
JMP L2 
JMP 100H 



JNC 
JC 



Ll+4 
L3 



JPO $+8 
JPE L4 



JP 

JM 



GAMMA 
al 



CALL 

CNZ 

CZ 

CNC 

CC 

CPO 

CPE 

CP 

CM 



SI 

S2 

100H 

Sl+4 

S3 

$+8 

S4 

GAMMA 

bl$c2 



RST 



Jump 
Jump 
Jump 
Jump 
Jump 
Jump 
Jump 
Jump 
Jump 

Call 
Call 
Call 
Call 
Call 
Call 
Call 
Call 
Call 



unconditionally to label 

on non zero condition to label 

on zero condition to label 

no carry to label 

on carry to label 

on parity odd to label 

on even parity to label 

on positive result to label 

on minus to label 



subroutine 
subroutine 
subroutine 
subroutine 
subroutine 
subroutine 
subroutine 
subroutine 
subroutine 



unconditionally 
if non zero flag 
on zero flag 
if no carry set 
if carry set 
if parity odd 
if parity even 
if positive result 
if minus flag 



Appendix 
E 



Programmed "restart", equivalent to 
CALL 8*e3, except one byte call 
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RET Return from subroutine 

RNZ Return if non zero flag set 

RZ Return if zero flag set 

RNC Return if no carry 

RC Return if carry flag set 

RPO Return if parity is odd 

RPE Return if parity is even 

RP Return if positive result 

RM Return if minus flag is set 

5.2. Immediate Operand Instructions. 

Several instructions are available v*iich load single or double precision 
registers, or single precision memory cells, with constant values, along with 
instructions vhich perform immediate arithmetic or logical operations on the 
accumulator (register A) . 

MVI e3,e8 MVI B,255 Move immediate data to register A, B, 

C, D, E, H, L, or M (memory) 
ADI e8 ADI 1 Add immediate operand to A without carry 
ACI e8 ACI 0FFH Add immediate operand to A with carry 
SUI eS SUI L + 3 Subtract from A without borrow (carry) 
SBI e8 SBI L AND IIB Subtract from A with borrow (carry) 
ANI e8 ANI $ AND 7FH Logical "and" A with immediate data 
XRI e8 XRI 1111$0000B "Exclusive or" A with immediate data 
ORI e8 ORI L AND 1+1 Logical "or" A with immediate data 
CPI e8 CPI 'a' Compare A with immediate data (same 

as SUI except register A not changed) 

LXI e3,el6 LXI B,100H Load extended immediate to register pair 

(e3 must be equivalent to B,D,H, or SP) 

5.3. Increment and Decrement Instructions. 

Instructions are provided in the 8080 repetoire for incrementing or 
decrementing single and double precision registers. The instructions are 

INR e3 INR E Single precision increment register (e3 

produces one of A, B, C, D, E, H, L, M) 
DCR e3 DCR A Single precision decrement register (e3 

produces one of A, B, C, D, E, H, L, M) 
INX e3 INX SP Double precision increment register pair 

(e3 must be equivalent to B,D,H, or SP) 
DCX e3 DCX B Double precision decrement register pair 

(e3 must be equivalent to B,D,H, or SP) 

5.4. Data Movement Instructions. 
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Instructions v*iich nDve c3ata from memory to the CPU and fran CPU to 
memory are given below 



IVDV e3,e3 MDV A,B 



LEAK e3 


T,rAX B 


STAX e3 


STAX 


D 


LHLD el 6 


LHLD 


LI 


SHT,n el6 


SHLD 


L5fx 


Lm el6 


LDA 


GamiiB 


STA el6 


STA 


X3-5 


POP e3 


POP 


PSW 


PUSH e3 


PUSH 


B 


IN e8 


IN 





our e8 


OUT 


255 


XTHL 






PCHL 






SPHL 






XCHG 







Move data to leftmost element from right- 
most element (e3 produces one of A,B,C 
D,E,H,L, or M), MOV M,M is disallowed 
Load register A from conputed address 
(e3 must produce either B or D) 
Store register A to computed address 
(e3 must produce either B or D) 
Load HL direct from location el6 (double 
precision load to H and L) 
Store HL direct to location el6 (double 
precision store from H and L to memory) 
Load register A from address el6 
Store register A into memory at el6 
Load register pair from stack, set SP 
(e3 must produce one of B, D, H, or PSW) 
Store register pair into stack, set SP 
(e3 must produce one of B, D, H, or PSW) 
Load register A with data from port e8 
Send data from register A to port e8 
Exchange data from top of stack with HL 
Fill program counter with data from HL 
Fill stack pointer with data fran HL 
Exchange DE pair with HL pair 



5.5. Arithmetic Logic Unit Operations. 

Instructions vdiich afct upon the single precision accumulator to perform 
arithmetic and logic operations are 

Add register given by e3 to accumulator 

without carry (e3 must produce one of A, 

B, C, D, E, E, or L) 

Add register to A with carry, e3 as above 

Subtract reg e3 from A without carry, 

e3 is defined as above 

Subtract register e3 from A with carry, 

e3 defined as above 

Logical "and" reg with A, e3 as above 

"Exclusive or" with A, e3 as above 

Logical "or" with A, e3 defined as above 

Compare register with A, e3 as above 

Decimal adjust register A based upon last 

arithmetic logic unit operation 

Complement the bits in register A 

Set the carry flag to 1 



ADD 


e3 


ADD 


B 


ADC 


e3 


ADC 


L 


SUB 


e3 


SUB 


H 


SBB 


e3 


SBB 


2 


ANA 


e3 


ANA 


1+1 


XRA 


e3 


XRA 


A 


ORA 


e3 


ORA 


B 


CMP 


e3 


CMP 


H 


DAA 








CMA 








STC 









Append 
E 
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CMC Complement the carry flag 

RLC Rotate bits left, (re) set carry as a side 

effect (high order A bit becomes carry) 
RRC Rotate bits right, (re) set carry as side 

effect (low order A bit becomes carry) 
RAL Rotate carry/A register to left (carry is 

involved in the rotate) 
RAR Rotate carry/A register to right (carry 

is involved in the rotate) 

DAD e3 DAD B Double precision add register pair e3 to 

HL (e3 must produce B, D, H, or SP) 

5«6. Control Instructions. 

The four remaining instructions are categorized as control instructions, 
and are listed below 

HLT Halt the 8080 processor 

DI Disable the interrupt system 

EI Enable the interrupt system 

NOP No operation 

6. ERROR MESSAGES. 

When errors occur within the assembly language program, they are listed as 
single character flags in the leftmost position of the source listing. The 
line in error is also echoed at the console so that the source listing need 
not be examined to determine if errors are present. The error codes are 

D Data error: element in data statement cannot be 
placed in the specified data area 

E Expression error: expression is ill-formed and 
cannot be computed at assembly time 

L Label error: label cannot appear in this context 
(may be duplicate label) 

N Not implemented: features which will appear in 

future ASM versions (e.g., macros) are recognized, 
but flagged in this version) 

Overflow: expression is too complicated (i.e., too 
many pending operators) to computed, simplify it 

P Phase error: label does not have the same value on 
two subsequent passes through the program 
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R 



V 



Register error: the value specified as a register 
is not compatible with the operation code 

Value error: operand encountered in expression is 
improperly formed 



Several error message 
conditions 



are printed vdnich are due to terminal error 



NO SOURCE FILE PRESENT 



The file specified in the ASM coitimand does 
not exist on disk 



NO DIRECTORY SPACE 



SOURCE FILE NAME ERROR 



SOURCE FILE READ ERROR 



OUTPUT FILE WRITE ERROR 



CANNOT CLOSE FILE 



The disk directory is full, erase files 
v\^ich are not needed, and retry 

Improperly formed ASM file name (e.g., it 
is specified with "?" fields) 

Source file cannot be read properly by the 
assembler, execute a TYPE to determine the 
point of error 

Output files cannot be written properly, most 
likely cause is a full disk, erase and retry 

Output file cannot be closed, check to see 
if disk is write protected 



7. A SAMPLE SESSION. 

The following session shows interaction with the assembler and debugger in 
the development of a simple assembly language program. 
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ASM soRTj OL%st*JcU 5o(2rT Asn. 

CP/M ASSEMBLER - VER 1 . 8 



ft 1 5C \M4c^ -fre^ oM!fess , V 

e03H USE FACTOR «% ^ H^lUtf as&( 00 ^O fF (^U»c&aecivCuU ) 
END OF ASSEMBLY 



DIR SORT. ♦, 



SORT 
SORT 
SORT 
SORT 
A>TYPE SORT. PRN. 



ASM Soi<u<i -piU 

B A K SooiktJ^-fn^ («iivf ««t'<.f 

PRN p«^u**- ftla (;iaw.1oii^s 4dL cUir«J<«,) 

HEX wacUivit codLt .fi4. 



Sbcu-c^ l»*^t, 



VvAc4uv<-e- Ctig- UacW ' 
0100 *<■ 

0100 214601*^ SORT: 

0103 3601 

0105 214701 

0108 3600 



SORT PROGRAM IN CP/M ASSEMBLY LANGUAGE 

START AT THE BEGINNING OF THE TRANSIENT PROGRAM 

ORG 100H 



LXI 
MVI 
LIU 
MVI 



H. SU 

n. 1 

H, I 
M, 



ADDRESS SWITCH TOGGLE 

SET TO 1 FOR FIRST ITERATION 

ADDRESS INDEX 

I = e 



010A 7E 
01&B FE09 
010D D219B1 



COMP: 



COMPARE I UITri ARRAY SIZE 



MOV 
CPI 
JNC 



A* M 
N-1 
CONT 



A REGISTER = I 

C Y SET IF I < ( H - 1 ) 

CONTINUE IF I <= <N-2) 



0110 214601 
0113 7EB7C20001 



END OF ONE PASS THROUGH DATA 

LKI H. SW ;CHECK FOR ZERO SWITCHES 

MOV A>H! ORA A! JNZ SORT ;EHD OF SORT IF 50=0 



0118 FF RST 7 jGO TO THE DEBUGGER INSTEAD OF I 

""^"^^^CONTINUE THIS PhSS 

ADDRESSING I. SO LOAD AV<I> INTO REGISTERS 

0119 5F16002148CONT: MOV E/ A ! MVI D, 0! LX I H. AV! DAD D! DAD D 




0121 4E7SI2346 



MOV CM! MOV A,C! INX H! MOV B.. M 

LOU ORDER BYTE IN A AND C. HIGH ORDER BYTE IN B 



0125 23 



MOV H AND L TO ADDRESS AV<1+1> 
INX H 



0126 965778239E 



COMPARE VALUE UITH REGS CONTAINING AV<I) 

SUB M! MOV D,A! MOV A, B ! INX H! SBB (1 iSUBTRAI 



012B DA3Fei 



BORROU SET IF AV<I+1) > AV< I > 

JC INCI jSKIP if IN PROPER ORDER 



012E B2CA3F01 



CHECK FOR EQUAL VALUES 

ORA D! jZ INC I ;SKIP IF AVM) = AV<I+1> I? 



itl52 56702B5E 
H36 712B722B73 



MOV ri,M! MOV M.. B! BCX H! MOV E.M 
MOV M.C! nCX H! 110V M. D ! IlCJ': H! MOV 



n, E 



J13B 2146B134 



INCREMENT SUITCH COUNT 
LXI H.SU! INR M 



J13F 2147ei34C31NCI 



INCREMENT I 
L!<I H. I ! INR M! 



JMP COMP 



ee 



H46 
3147 
3148 

3 I 5 C 

>TYPE SORT 



SU: 
I: 

05e06400lEAV: 
HEX^ 



DATA 

DB 

DB 

Dili 

EQU 

END 



DEFINITION 
; 
1 

5 . 1 fi . 3 i 
<*-AV)/2 



SWITCH COUNT 



SECTION 

^RESERVE SPACE FOR 

; SPACE FOR INDEX 

0. 20. 7, 1000/ 390.. 100, -32767 
;COMPUTE N INSTEAD OF 



PRE 



£6902190140 *) 
102148011983 f 
)A3F0 1B2CAA7 f 



J 



1 00 1000021 460 1360 121 470 1 36007EF 

100 11 00021 460 17EB7C20001FF5F 160 

10012000 194E792 346 23 96577 8 23 9ED 

1 00 13000 3F 1 567 2B5E 7 12B72 2B732 1460 1 342 1C7 

370 14000470 134C30A01006E 

10014 800 050 06400 1E00 3 20 01400 07 00E8032C01BB 

J401580064000180BE 

3000000000 

>DDT SORT. HEX, ^y4 dit'iw^ mvv. 

5K DDT VER I. v 

isJ 0000 dekJ^ad^ess 0^ ad<k.^ o. S;Ps-k4cme^J 






= 0000 10 0. CWvvfl^?<^'h' l*^*^ 



J IP F p F ., UvxVvooS "W i'SSVi' S-{q>5 






3Z0M0E0I0 A = 00 B = 0000 D = 0000 H = 0000 S=0100 P = 0100 LXI H.. 0146^0108 

ri0^ -^c^ce. I0,^'sf«p? 



3Z0M0E0I0 
3Z0M0E0I0 
a20M0E0I0 
320MBE0I0 
aZ0MOE0I0 
320M0E0I0 
120M1E010 
1Z0M1E0I0 
120M1E0I0 
1Z0M1E0I0 
9Z0M0E0I0 
3Z0M0E0I0 
aZ0M0E010 
3Z0MBE010 
E)Z0M0E0I0 
0Z0M0E0I0 
f^l0D 



A = B1 B 

A = 01 B 

A = 01 B 

A = ei B 

A = 01 B 

A = 00 B 

A = 00 B 

A = 00 B 

A = 00 B 

A = 01 B 

A = 01 B 

A = 01 B 

A = 01 B 

A = 01 B 

A = 01 B 

A = 01 B 



= 0000 

= 0000 
= 0000 
= 0000 
= 0000 
= 0000 
= 0000 
= 0000 
= 0000 
= 0000 
= 0000 
= 0000 
= 0000 
= 0000 
= 0000 
= 000 



D = 00 

D = 00 
D = 00 
D = B0 
D = 60 
D = 00 
D = 

D=0 

D = 00 
D = 00 
D = 00 
D = 00 
D = 00 
D = 00 
D = &0 
D = 00 



00 H = 

00 H: 

00 H^ 

00 H^ 

00 H^ 

00 H^ 

00 W- 

00 H^ 

00 H^ 

00 H^ 

00 W- 

00 H: 

00 H^ 

00 H^ 

00 H: 

00 H^ 



0146 
0146 
0146 
0147 
0147 
01 47 
014 7 
0147 
01 46 
0146 
0146 
0146 
0146 
0146 
0147 
J 4 7 



S=0100 
S=01 00 

S=01 00 

S=-01 00 
S=01 00 
S=01 00 
S=01 00 
S = 1 
S=01 00 
S=0100 
S=0100 
S=0100 
S=0100 
S=0100 
S=0100 
S=01 00 



P=0100 

P=0103 
P«0 105 
P:--0 103 
P==0 10A 

P==0 10B 

P=0 10D 
P=0110 

P=0 113 
P=0114 
P=0115 

P=0100 
P=0 103 

P=0 105 

P = 1 8 

P = 1 A 



LXI 

MVI 
LXI 
MVI 
MOV 
CPI 
JNC 
LXI 
MOV 
ORA 
JNZ 
LXI 
MVI 
LXI 
MVI 
MOV 



H.0146 
M, 1 
H, 0147 
M> 
A, M 
9 
113 
H .. 1 4 6 
A. M 
A 

0100 
H. 0146 
M, 01 
H.0147 
M . 
A, M*0 1 0B 



Append! 
E 



10D JC 119, cUii^64D ajuwx? Gvy OXrru 






J 



1? 



P=010B 



100 



' ■ ^ (Oh 5-fefS 



-Tie, -^roce. e«K«.4tOA -r<^ 



c0zeHeE0i0 

C02et10E0I0 
C02eM0E010 
C020M0E0I0 
C0ZeM0E0I0 
C020MBE0I0 
C120mE0I0 
C1Z0M1E0I0 

ci2ernE0i0 

C120M1E0I0 

ci2ehHE0i0 
•e020mE0i0 
cezeiiiEeie 

C020M1E0I0 
C020M1E0I0 

C0Z0riiE0i0 

-L100, 



8100 

0103 

0105 

0108 

0101^ 
010B 

010D 
01 10 
01 13 
01 14 
01 15 
-L -, 



0118 RST 

0119 MOV 

011A nvi 

BllC LXI 

aUv4 lv4+ 



A = 00 

A = 00 

A = 00 

A = 00 
A = 
A = 00 
A = 00 
A = e0 
A = e0 

A = 00 

A = 00 
A = 00 
A = 00 
A = 00 
A = 05 
A = 05 



B=0000 
8=6000 

0=0000 

B=0000 
B=0000 
B=0000 
B=6000 

B=0000 

0=0000 
B=0000 
B=0000 
B=0000 

B=e000 
B=e005 

B=0005 
B=B005 



ll=0 00 
D=0000 

D=B000 
D=B000 
D=B000 
D=0000 

D=0000 
ll=0 00 

D=0000 
D=0000 
D=0 00 
D=0000 

11 = 00 

0=0 00 

[1=0 00 

0=0000 



H=014? 
H=0146 
H=0146 
H=0147 
H=0147 
H=014? 
H=014? 
H=0147 
H=0147 
H=014P 
H=0148 
H=0148 
H=0148 
H=0148 
H=0148 
H=01 49 



S=0100 
S=0100 
S=0100 

S •- 1 

S=0100 
S=0100 

S=01 00 

S=0100 
S=0100 
S=0100 
S=0100 

S=0100 

S = i & 6 

S = 1 15 
S=0100 
S=01 00 



P=0100 
P=0 103 
P=0 105 

p=0ie8 

P=010A 

P=0 10B 

P=010D 

P=0119 
P=011A 
P=0ll C 
P=011F 
P=0120 
P=8121 
P = £il22 
P=0123 
P=0124 



LXI 

MVI 

LXI 

MVI 

MOV 

CPI 

JC 

MOV 

MVI 

L>!1 

CAD 

DAD 

HO'V 

MOV 

INX 

MOV 










CO 



u 



07 
E. A 

0.00 

H,0 148 



\^ WU/Vd 



H, 0146 
M . 1 
H. 0147 

M , 
A, M 
09 

0119 
E.. A 
D> 00 
H .. 1 4 8 
D 
D 



(^ 



A^^ 






.¥ 



^ 



c 

M*B1 25 



-G. 1 18, 6-M -^oyxu^-^n^^ curves 

*0127 '54opf<r^ lA^^-H. avt exk^vJ^ (iA:Wmp4 7 -fKi^-(r^j 'p^v.ef^^fK'^Kau* wets 

^^ loolc ok loofn^ -pw-j/AiM is^-kyvce moi^ ^ 

;8M0E0I0 A=38 B=0064 D=0006 H=0156 



'14 



Tkzm* lymr yav.^^ v 



C02 

C020M0E010 

C020M0E0I0 

C.0Z0M0E0I0 

-D148 



A = 38 
A = 00 

A = 



8=0064 
B=0064 
8=6064 



D=3806 
D=3806 
D=3 806 



H=0156 
H=0156 
H = €il57 



S=0100 
S=0100 
£=0100 

S = 1 



P=0127 

P=0128 
P:=0129 
P=0 1 2:A 



MOV 

MOV 
I NX 
SBB 



D. A 
A. B 

H 

M*0 12B 



0148 05 
0150 32 
0160 00 



00 

00 

00 



07 
64 

00 



00 

00 
00 



14 
64 
08 



00 
80 
00 



IE 

2C 

00 



00 
01 
00 



(.^ ^M-{edy \pu^ V'io^iuv* ({oC-S<^t STc5p . 



E8 

00 



03 



01 
00 



80 
00 



00 

00 



00 

00 



00 
00 



00 2 
00 . 



D. L 



■&0- irelurA \o C?/U 



mm 



DDT SORT. HEX , reload "Huf menvf^^i^ lO^A^iS 

16K DDT VER 1. 
NEXT PC 
ei5C 0000 
-XP 

P = 000e 100 1 SelfC 4o W^mmvy c5T'p^<'Jl 

010D JNC ©IIS*^ 
0110 LXl H,0146 



010D 



01 10: 



JC 119- 



. L 1 \\'^^ 5Wv4v^ sectu^ oF -^/o^vanA, 



0100 LXI 

0103 MVI 

0105 LXI 

0108 MVI 



H.0146 
M. 01 
H. 0147 
M. 00 



- A 1 3 J cUxv^ SWi4-tiA 
0103 MVI M,0j 

01 05 1 



[^^.<.\\<dl^o^;^ 4> 0^ 



SAVE 1 S0RT.COM, $AV€ 1 ^^-^^ Cz?*^ Uj^«,-f«v»^ lOOH-blR^K) cy^. <ii5.|6 vCn C^SC- 
A>DDT S0RT.COM, t^'S.Uv^ DX>T ujcVU 
16K DDT VER 1. 

S'^e eie. -COK*" -f,!. .Us^ ^W*- "* «^-* '~^ 

*0118 -ovzvj/aiAvvKecl iWp ^e-Sr?! filA£i,u»^^«<^ 

^- Ado. -jvcxj^Ui -sorfe^ 

0148 05 00 07 00 14 60 IE 00^ 

0150 32 00 64 00 64 00 2C 1 ES 03 01 80 00 00 00 00 2.D.D., 

0160 00 00 00 00 00 00 00 00 00 00 00 00 08 00 00 00 

0170 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 
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- G0^ fe{tx^^ -^o efiU 



Zl 



ED SORT. ASM, /wat^ cU^iAa^S -\d CVv4\vu»-I 'PvoavO^^ 
* N . ef 2)0 T T^ -fivAa »\£'£'" "> *^" 

^*-^ M IJ T M ft 



MVI 
'u« PAe Ue ii^ 



♦ Lai 



^ "i ^^ (X\/^(M^^ line 

MVI M.l 

*^Klj V^tU lue ^ 43f^ *>^ ^i«^ 



LXI 
MVI 



* I^ iwsM ^^•^ \yyJL. 



JNC*Tj 
COHT 

*-2DicQeilt^ 



f1 .. J I = 

H.. I ; A II DRESS INDEX 

iSET TO I FOR FIRST ITERATION 
H.I >ADDRESS INDEX 
M.0 ;ZERO SU 
H.I iADDRESS INDEX 

;CONTIHUE IF I <= (H-2> 



JC 



CONT 



^CONTINUE IF I <= <H-2) 



*E 



ASM SORT. AAZjr"5WCp?ifr<+.i« 
CP/M ASSEMBLER - VER 1 .0 

003H USE FACTOR 
END OF ASSEMBLY 

ODT SORT. HEX , -{esi- ^ajVAi** cU^i^ii 

ifcK DDT VER 1. 
NEXT PC 
Lil5C 00 
- G 1 ) 



*01 1 « 
-D1482 



^ ck-K Stx-'^^ 



0148 05 00 97 00 14 00 IE 00 

0150 22 00 64 00 64 80 2C 01 E8 03 01 80 08 80 00 08 2.D.D.. 

160 00 00 00 00 00 00 00 00 00 00 00 08 08 80 90 Be 
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1. INTRODUCTION. 



This manual describes CP/M^ release 2, system organization 
including the structure of memory and system entry points. The 
intention is to provide the necessary information required to write 
programs which operate under CP/M^ and which use the peripheral and 
disk I/O facilities of the system. 

CP/M is logically divided into four parts^ called the Basic I/O 



(BDOS) , the Console 
Area (TPA) . The 
the exact low level 
is necessary for 
BIOS is supplied by 



System (BIOS) , the Basic ^ Disk Operating System 
command processor (CCP) , and the Transient Program 
BIOS is a hardware-dependent module which defines 
interface to a particular computer system which 
peripheral device I/O. Although a standard 
Digital Research, explicit instructions are provided for field 
reconfiguration of the BIOS to match nearly any hardware environment 
(see the Digital Research manual entitled "CP/M Alteration Guide") . 
The BIOS and BDOS are logically combined into a single module with a 
common entry point, and referred to as the FDOS. The CCP is a 
distinct program which uses the FDOS to provide a human-oriented 
interface to the information which is cataloged on the backup storage 
device. The TPA is an area of memory (i.e., the portion which is not 
used by the FDOS and CCP) where various non-resident operating system 
commands and user programs are executed. The lower portion of memory 
is reserved for system information and is detailed later sections. 
Memory organization of the CP/M system in shown below; 



high 
memory 

FBASE: 



CBASE; 



TBASE: 



BOOT: 



FDOS (BDOS+BIOS) 



CCP 



TPA 



system parameters 



rhe exact memory addresses corresponding to BOOT, TBASE, CBASE, and 
FBASE vary from version to version, and are described fully in the 
"CP/M Alteration Guide." All standard CP/M versions, however, assume 
BOOT = 0000H, which is the base of random access memory. The machine 
code found at location BOOT performs a system "warm start" which loads 
and initializes the programs and variables necessary to return control 
to the CCP. Thus, transient programs need only jump to location BOOT 
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to return control to CP/M at the command level. Further^ the standard 
versions assume TBASE = BOOT+0100H which is normally location 0100H, 
The principal entry point to the FDOS is at location BOOT+0005H 
(normally 0005H) where a jump to PHASE is found. The address field at 
BOOT-f0006H (normally 0006H) contains the value of FBASE and can be 
used to determine the size of available memory, assuming the CCP is 
being overlayed by a transient program. 

Transient programs are loaded into the TPA and executed as 
follows. The operator communicates with the CCP by typing command 
lines following each prompt. Each command line takes one of the 
forms: 

command 
command filel 
command filel file2 

where "command** is either a built-in function such as DIR or TYPE, or 
the name of a transient command or program. If the command is a 
built-in function of CP/M, it is executed immediately. Otherwise, the 
CCP searches the currently addressed disk for a file by the name 

command.COM 

If the file is found, it is assumed to be a memory image of a program 

which executes in the TPA, and thus implicitly originates at TBASE in 

memory. The CCP loads the COM file from the disk into memory starting 
at TBASE and possibly extending up to CBASE. 

If the command is followed by one or two file specifications, 
the CCP prepares one or two file control block (FCB) names in the 
systan parameter area. These optional FCB's are in the form necessary 
to access files through the FDOS, and are described in the next 
section. 

The transient program receives control from the CCP and begins 
execution, perhaps using the I/O facilities of the FDOS. The 
transient program is "called" from the CCP, and thus can simply return 
to the CCP upon completion of its processing, or can jump to BOOT to 
pass control back to CP/M. In the first case, the transient program 
must not use memory above CBASE, while in the latter case, memory up 
through FBASE-1 is free. 

The transient program may use the CP/M I/O facilities to 
communicate with the operator's console and peripheral devices, 
including the disk subsystem. The I/O system is accessed by passing a 
"function number" and an "information address" to CP/M through the 
FDOS entry point at BOOT+0005H. In the case of a disk read, for 
example, the transient program sends the number corresponding to a 
disk read, along with the address of an FCB to the CP/M FDOS. The 
FDOS, in turn, performs the operation and returns with either a disk 
read completion indication or an error number indicating that the disk 
read was unsuccessful. The function numbers and error indicators are 
given in below. 
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2. OPERATING SYSTEM CALL CONVENTIONS. 

The purpose of this section is to provide detailed information 
for performing direct operating system calls from user programs. Many 
of the functions listed below, however, are more simply accessed 
through the I/O macro library provided with the MAC macro assembler, 
and listed in the Digital Research manual entitled "MAC Macro 
Assembler: Language Manual and Applications Guide." 

CP/M facilities which are available for access by transient 
programs fall into two general categories: simple device I/O, and 
disk file I/O. The simple device operations include: 

Read a Console Character 

Write a Console Character 

Read a Sequential Tape Character 

Write a Sequential Tape Character 

Write a List Device Character 

Get or Set I/O Status 

Print Console Buffer 

Read Console Buffer 

Interrogate Console Ready 

rhe FDOS operations which perform disk Input/Output are 

Disk System Reset 

Drive Selection 

File Creation 

File Open 

File Close 

Directory Search 

File Delete 

File Rename 

Random or Sequential Read 

Randan or Sequential Write 

Interrogate Available Disks 

Interrogate Selected Disk 

Set DMA Address 

Set/Reset File Indicators 



As mentioned above, access to the FDOS functions is 
Dy passing a function number and information address 
primary entry point at location BOOT+0005H. In general, 
lumber is passed in register C with the information add 
3ouble byte pair DE. Single byte values are returned i 
vith double byte values returned in HL (a zero value is r 
bhe function number is out of range) . For reasons of c 
register A = L and register B = H upon return in all case 
:he register passing conventions of CP/M agree with those 
?L/M systems programming language. The list of CP/M fun 
Ls given below. 



accomplished 

through the 

the function 

ress in the 

n register A, 

eturned when 

ompatibility, 

s. Note that 

of Intel's 

ctidn numbers 
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System Reset 

1 Console Input 

2 Console Output 

3 Reader Input 

4 Punch Output 

5 List Output 

6 Direct Console I/O 

7 Get I/O Byte 

8 Set I/O Byte 

9 Print String 

10 Read Console Buffer 

11 Get Console Status 

12 Return Version Number 

13 Reset Disk System 

14 Select Disk 

15 Open File 

16 Close File 

17 Search for First 

18 Search for Next 



19 Delete File 

20 Read Sequential 

21 Write Sequential 

22 Make File 

23 Rename File 

24 Return Login Vector 

25 Return Current Disk 

26 Set DMA Address 

27 Get Addr(Alloc) 

28 Write Protect Disk 

29 Get R/0 Vector 

30 Set File Attributes 

31 Get Addr(Disk Parms) 

32 Set/Get User Code 
3 3 Read Random 

34 Write Random 

35 Compute File Size 

36 Set Random Record 



(Functions 28 and 32 should be avoided in 
maintain upward compatibility with MP/M,) 



application programs to 



Upon entry to a transient program^ the CCP leaves the stack 
pointer set to an eight level stack area with the CCP return address 
pushed onto the stacks leaving seven levels before overflow occurs. 
Although this stack is usually not used by a transient program (i.e,^ 
most transients return to the CCP though a jump to location 0000H) , it 
is sufficiently large to make CP/M system calls since the FDOS 
switches to a local stack at system entry. The following assembly 
language program segment^ for example, reads characters continuously 
until an asterisk is encountered, at which time control returns to the 
CCP (assuming a standard CP/M system with BOOT = 0000H) : 

; STANDARD CP/M ENTRY 
;CONSOLE INPUT FUNCTION 

;BASE OF TPA 

;READ NEXT CHARACTER 

; RETURN CHARACTER IN <A> 

;END OF PROCESSING? 

;LOOP IF NOT 

; RETURN TO CCP 



BDOS 


EQU 


05H 


CONIN 


EQU 


1 


/ 


ORG 


0100H 


NEXTC: 


MVI 


C, CON IN 




CALL 


BDOS 




CPI 


• * • 




JNZ 


NEXTC 




RET 






END 





CP/M implements a named file structure on each disk^ providing a 
logical organization which allows any particular file to contain any 
number of records from completely empty ^ to the full capacity of the 
drive. Each drive is logically distinct with a disk directory and 
file data area. The disk file names are in three parts: the drive 
select code^ the file name consisting of one to eight non-blank 
characters, and the file type consisting of zero to three non-blank 
characters. The file type names the generic category of a particular 
file, while the file name distinguishes individual files in eacl: 
category. The file types listed below name a few generic categories 
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which have been established^ although they are generally arbitrary: 

ASM Assembler Source PLI PL/I Source File 

PRN Printer Listing REL Relocatable Module 

HEX Hex Machine Code TEX TEX Formatter Source 

BAS Basic Source File BAK ED Source Backup 

INT Intermediate .Code SYM SID Symbol File 

COM CCP Command File $$$ Temporary File 

Source files are treated as a sequence of ASCII characters^ where each 
"line" of the source file is followed by a carriage-return line-feed 
sequence (0DH followed by 0AH) , Thus one 128 byte CP/M record could 
contain several lines of source text. The end of an ASCII file is 
denoted by a control-Z character (lAH) or a real end of file, returned 
by the CP/M read operation. Control-Z characters embedded within 
machine code files (e.g., COM files) are ignored, however, and the end 
of file condition returned by CP/M is used to terminate read 
operations. 

Files in CP/M can be thought of as a sequence of up to 65536 
records of 128 bytes each, numbered from through 65535, thus 
allowing a maximum of 8 megabytes per file. Note, however, that 
although the records may be considered logically contiguous, they may 
not be physically contiguous in the disk data area. Internally, all 
files are broken into 16K byte segments called logical extents, so 
that counters are easily maintained as 8-bit values. Although the 
decomposition into extents is discussed in the paragraphs which 
follow, they are of no particular consequence to the programmer since 
each extent is automatically accessed in both sequential and random 
access modes. 

In the file operations starting with function number 15, DE 
usually addresses a file control block (FCB) . Transient programs 
often use the default file control block area reserved by CP/M at 
location BOOT+005CH (normally 005CH) for simple file operations. The 
basic unit of file information is a 128 byte record used for all file 
operations, thus a default location for disk I/O is provided by CP/M 
at loca.tion BOOT+0080H (normally 0080H) which is the initial default 
DMA address (see function 26) . All directory operations take place in 
a reserved area which does not affect write buffers as was the case in 
release 1, with the exception of Search First and Search Next, where 
compatibility is required. 

The File Control Block (FCB) data area consists of a sequence of 
33 bytes for sequential access and a series of 36 bytes in the case 
that the file is accessed randanly. The default file control block 
normally located at 005CH can be used for random access files, since 
the three bytes starting at BOOT+007DH are available for this purpose. 
The FCB format is shown with the following fields: 



^^^ 
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|dr|fl|f2|/ /If8|tl|t2|t3|ex|sl|s2|rc|d0|/ / |dn |cr I r0 I rl I r2 I 
00 01 02 ... 08 09 10 11 12 13 14 15 16 ... 31 32 33 34 35 
where 

dr drive code (0 - 16) 

=> use default drive for file 

1 => auto disk select drive A^ 

2 => auto disk select drive B, 
• • • 

16=> auto disk select drive P. 

fl...f8 contain the file name in ASCII 
upper case^ with high bit = 

tl^t2^t3 contain the file type in ASCII 
upper case, with high bit = 
tl', t2\ and t3' denote the 
bit of these positions, 
tl' = 1 => Read/Only file, 
t2' = 1 => SYS file, no DIR list 

ex contains the current extent number, 
normally set to 00 by the user, but 
in range - 31 during file I/O 

si reserved for internal system use 

s2 reserved for internal system use, set 
to zero on call to OPEN, MAKE, SEARCH 

re record count for extent "ex," 
takes on values from - 128 

d0...dn filled-in by CP/M, reserved for 
system use 

cr current record to read or write in 

a sequential file operation, normally 
set to zero by user 

r0,rl,r2 optional random record number in the 
range 0-65535, with overflow to r2, 
r0,rl constitute a 16-bit value with 
low byte r0, and high byte rl 

Each file being accessed through CP/M must have a corresponding 
FCB which provides the name and allocation information for all 
subsequent file operations. When accessing files, it is the 
programmer's responsibility to fill the lower sixteen bytes of the FCB 
and initialize the "cr" field. Normally, bytes 1 through 11 are set 
to the ASCII character values for the file name and file type, while 
all other fields are zero. 
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FCB's are stored in a directory area of the disk, and are 
Drought into central memory before proceeding with file operations 
(see the OPEN and MAKE functions) . The memory copy of the FCB is 
apdated as file operations take place and later recorded permanently 
:)n disk at the termination of the file operation (see the CLOSE 
command) . 

The CCP constructs the first sixteen bytes of two optional FCB's 
for a transient by scanning the remainder of the line following the 
transient name, denoted by "filel" and "file2" in the prototype 
::ommand line described above, with unspecified fields set to ASCII 
blanks. The first FCB is constructed at location BOOT+005CH, and can 
be used as-is for subsequent file operations. The second FCB occupies 
the d0 ... dn portion of the first FCB, and must be moved to another 
area of memory before use. If, for example, the operator types 

PROGNAME BrX.ZOT Y.ZAP 

the file PR0GNAME.COM is loaded into the TPA, and the default FCB at 
BOOT+005CH is initialized to drive code 2, file name "X" and file type 
"ZOT". The second drive code takes the default value 0, which is 
placed at BOOT+006CH, with the file name ''Y" placed into location 
BOOT+006DH and file type "ZAP" located 8 bytes later at BOOT-f0075H. 
All remaining fields through "cr" are set to zero. Note again that it 
is the programmer's responsibility to move this second file name and 
type to another area, usually a separate file control block, before 
opening the file which begins at BOOTH-005CH, due to the fact that the 
open operation will overwrite the second name and type. 

If no file names are specified in the original command, then the 
fields beginning at BOOT+005DH and BOOT+006DH contain blanks. In all 
cases, the CCP translates lower case alphabetics to upper case to be 
consistent with the CP/M file naming conventions. 

As an added convenience, the default buffer area at location 
BOOT+0080H is initialized to the command line tail typed by the 
operator following the program name. The first position contains the 
number of characters, with the characters themselves following the 
character count. Given the above command line, the area beginning at 
BOOT+0080H is initialized as follows: 

BOOT-f0080H: 

+00 +01 +02 +03 +04 +05 +06 +07 +08 +09 +10 +11 +12 +13 +14 

where the characters are translated to upper case ASCII with 
uninitialized memory following the last valid character. Again, it is 

the responsibility of the programmer to extract the information from 
this buffer before any file operations are performed, unless the 
default DMA address is explicitly changed. 

The individual functions are described in detail in the pages 
which follow. 
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* * 

* FUNCTION 0: System Reset * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 00H * 
*************************************** 



The system reset function returns control to the CP/M operating 
system at the CCP level. The CCP re-initializes the disk subsystem by 
selecting and logging-in disk drive A. This function has exactly the 
same effect as a jump to location BOOT. 

*************************************** 

* * 

* FUNCTION 1: CONSOLE INPUT * 

* * 
*************************************** 

* Entry Parameters: * 

* Register C: 01H * 

* * 

* Returned Value: * 

* Register A: ASCII Character * 
*************************************** 

The console input function reads the next console character to 
register A. Graphic characters^ along with carriage return^ line 
feed^ and backspace (ctl-H) are echoed to the console. Tab characters 
(ctl-I) are expanded in columns of eight characters. A check is made 
for start/stop scroll (ctl-S) and start/stop printer echo (ctl-P) . 
The FDOS does not return to the calling program until a character has 
been typed^ thus suspending execution if a character is not ready. 

*************************************** 

* * 

* FUNCTION 2: CONSOLE OUTPUT * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 02H * 

* Register E: ASCII Character * 

* * 

*************************************** 

The ASCII character from register E is sent to the console 
device. Similar to function 1, tabs are expanded and checks are made 
for start/stop scroll and printer echo. 
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************************************** 

* 

FUNCTION 3: READER INPUT * 

* 

:************************************** 

' Entry Parameters: * 

' Register C: 03H * 

t * 

^ Returned Value: * 

' Register A: ASCII Character * 

t ************************************** 

The Reader Input function reads the next character from the 
Logical reader into register A (see the lOBYTE definition in the "CP/M 
Alteration Guide"), Control does not return until the character has 
Deen read. 

*************************************** 
k * 

* FUNCTION 4: PUNCH OUTPUT * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 04H * 

* Register E: ASCII Character * 

* * 

*************************************** 

The Punch Output function sends the character from register E to 
the logical punch device. 

*************************************** 

* * 

* FUNCTION 5: LIST OUTPUT * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 05H * 

* Register E: ASCII Character * 

* * 

*************************************** 

The List Output function sends the ASCII character in register E 
to the logical listing device. 



Append 
F 
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*************************************** 

* * 

* FUNCTION 6: DIRECT CONSOLE I/O * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 06H * 

* Register E: 0FFH (input) or * 

* char (output) * 

* * 

* Returned Value: * 

* Register A: char or status * 

(no value) * 

************************:»:************** 

Direct console I/O is supported under CP/M for those specializec 
applications where unadorned console input and output is required, 
Use of this function should, in general, be avoided since it bypasses 
all of CP/M's normal control character functions (e.g., control-S anc 
control-P) . Programs which perform direct I/O through the BIOS undei 
previous releases of CP/M, however, should be changed to use direcl 
I/O under BDOS so that they can be fully supported under future 
releases of MP/M and CP/M. 

Upon entry to function 6, register E either contains hexadecimal 
FF, denoting a console input request, or register E contains an ASCI] 
character. If the input value is FF, then function 6 returns A = 0{ 
if no character is ready, otherwise A contains the next console inpul 
character. 

If the input value in E is not FF, then function 6 assumes thai 
E contains a valid ASCII character which is sent to the console. 
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*************************************** 

* * 

* FUNCTION 7: GET I/O BYTE * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 07H * 

* * 

* Returned Value: * 

* Register A: I/O Byte Value * 
*************************************** 



The Get I/O Byte function returns the current value of lOBYTE in 
register A, See the "CP/M Alteration Guide" for lOBYTE definition. 



******* ***********:/t****^**^**^*****^^^* 

* * 

* FUNCTION 8: SET I/O BYTE * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 08H * 

* Register E: I/O Byte Value * 

* * 
*************************************** 



The Set I/O Byte function changes the system lOBYTE value to 
that given in register E. 



*************************************** 

* * 

* FUNCTION 9: PRINT STRING * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 09H * 

* Registers DE: String Address * 

* * 

*************************************** 



The Print String function sends the character string stored in 

memory at the location given by DE to the console device^ until a "$" 

is encountered in the string. Tabs are expanded as in function 2, and 
checks are made for start/stop scroll and printer echo. 
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*************************************** 

* ^ * 

* FUNCTION 10: READ CONSOLE BUFFER * 

* * 

* Entry Parameters: * 

* Register C: 0AH * 

* Registers DE: Buffer Address * 

* * 

* Returned Value: * 

* Console Characters in Buffer * 
***********************************vt*** 

The Read Buffer function reads a line of edited console input 
into a buffer addressed by registers DE. Console input is terminated 
when either the input buffer overflows. The Read Buffer takes the 
form: 

DE: +0 +1 +2 +3 +4 +5 +6+7+8 ... +n 

Imx|nc|cl|c2|c3|c4|c5|c6|c7| . . . |??l 



where "mx" is the maximum number of characters which the buffer will 
hold (1 to 255) , "nc** is the number of characters read (set by FDOS 
upon return)^ followed by the characters read from the console. if nc 
< mx^ then uninitialized positions follow the last character, denoted 
by "??•• in the above figure. A number of control functions are 
recognized during line editing: 

rub/del removes and echoes the last character 

ctl-C reboots when at the beginning of line 

ctl-E causes physical end of line 

ctl-H backspaces one character position 

ctl-J (line feed) terminates input line 

ctl-M (return) terminates input line 

ctl-R retypes the current line after new line 

ctl-U removes currnt line after new line 

ctl-x backspaces to beginning of current line 

Note also that certain functions which return the carriage to the 
leftmost position (e.g., ctl-X) do so only to the column position 
where the prompt ended (in earlier releases, the carriage returned to 
the extreme left margin) . This convention makes operator data input 
and line correction more legible. 
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f ************************************** 
f * 

' FUNCTION 11: GET CONSOLE STATUS * 

: * 

f ************************************** 

' Entry Parameters: * 

' Register C: 0BH * 

f * 

' Returned Value: * 

' Register A: Console Status * 

t**** ********************************** 

The Console Status function checks to see if a character has 
:>een typed at the console. If a character is ready^ the value 0FFH is 
returned in register A. Otherwise a 00H value is returned. 

If************************************** 

k * 

^ FUNCTION 12: RETURN VERSION NUMBER * 
t * 

If************************************** 

^ Entry Parameters: * 

^ Register C: 0CH * 

If * 

"f Returned Value: * 

■^ Registers HL: Version Number * 
If************************************** 

Function 12 provides information which allows version 
Independent programming. A two-byte value is returned^ with H = 00 
designating the CP/M release (H = 01 for MP/M) , and L = 00 for all 
releases previous to 2.0. CP/M 2.0 returns a hexadecimal 20 in 
register L^ with subsequent version 2 releases in the hexadecimal 
range 21^ 22^ through 2F. Using function 12, for example, you can 
vrite application programs which provide both sequential and random 
access functions, with 'random access disabled when operating under 
Barly releases of CP/M. 



Appendix 
F 
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*************************************** 

* * 

* FUNCTION 13: RESET DISK SYSTEM * 

* * 
*************************************** 

* Entry Parameters: * 

* Register C: 0DH * 

* * 

*************************************** 



The Reset Disk Function is used to programmatically restore the 
file system to a reset state where all disks are set to read/write 
(see functions 28 and 29) , only disk drive A is selected^ and the 
default DMA address is reset to BOOT+0080H. This function can be 
used, for example, by an application program which requires a disk 
change without a system reboot. 



*************************************** 

* * 

* FUNCTION 14: SELECT DISK * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 0EH * 

* Register E: Selected Disk * 

* * 

*************************************** 

The Select Disk function designates the disk drive named in 
register E as the default disk for subsequent file operations, with E 
= for drive A, 1 for drive B, and so-forth through 15 corresponding 
to drive P in a full sixteen drive system. The drive is placed in an 
"on-line" status which, in particular, activates its directory until 
the next cold start, warm start, or disk system reset operation. If 
the disk media is changed while it is on-line, the drive automatically 
goes to a read/only status in a standard CP/M environment (see 
function 28). FCB's which specify drive code zero (dr = 00H) 
autonatically reference the currently selected default drive. Drive 
code values between 1 and 16, however, ignore the selected default 
drive and directly reference drives A through P. 
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* * 

* FUNCTION 15: OPEN FILE * 

* Entry Parameters: * 

* Register C: 0FH * 

* Registers DE: FCB Address * 

* • 

* Returned Value: * 

* Register A: Directory Code * 

*************************************** 



The Open File operation is used to activate a file which 
currently exists in the disk directory for the currently active user 
number. The FDOS scans the referenced disk directory for a match in 
positions 1 through 14 of the FCB referenced by DE (byte si is 
automatically zeroed) , where an ASCII question mark (3FH) matches any 
directory character in any of these positions. Normally^ no question 
marks are included and, further, bytes "ex" and "s2" of the FCB are 
zero. 

If a directory element is matched, the relevant directory 
information is copied into bytes d0 through dn of the FCB, thus 
allowing access to the files through subsequent read and write 
operations. Note that an existing file must not be accessed until a 
sucessful open operation is completed. Upon return, the open function 
returns a "directory code" with the value through 3 if the open was 
successful, or 0FFH (255 decimal) if the file cannot be found. If 
question marks occur in the FCB then the first matching FCB is 
activated. Note that the current record ("cr") must be zeroed by the 
program if the file is to be accessed sequentially from the first 
record. 
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******:lt*************** ***************** 

* * 

* FUNCTION 16: CLOSE FILE * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 10H * 

* Registers DE: FCB Address * 

* * 

* Returned Value: * 

* Register A: Directory Code * 

*************************************** 

The Close File function performs the inverse of the open file 
function. Given that the FCB addressed by DE has been previously 
activated through an open or make function (see functions 15 and 22) , 
the close function permanently records the new FCB in the referenced 
disk directory. The FCB matching process for the close is identical 
to the open function. The directory code returned for a successful 
close operation is 0, 1, 2, or 3, while a 0FFH (255 decimal) is 
returned if the file name cannot be found in the directory. A file 
need not be closed if only read operations have taken place. If write 
operations have occurred, however, the close operation is necessary to 
permanently record the new directory information. 
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*************************************** 

* * 

* FUNCTION 17: SEARCH FOR FIRST * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: IIH * 

* Registers DE: FCB Address 



* 
* 

* Returned Value: * 

* Register A: Directory Code * 
*************************************** 



Search First scans the directory for a match with the file given 
by the FCB addressed by DE. The value 255 (hexadecimal FF) is 
returned if the file is not found, otherwise 0, 1, 2, or 3 is returned 
indicating the file is present. In the case that the file is found, 
the current DMA address is filled with the record containing the 
directory entry, and the relative starting position is A * 32 (i.e., 
rotate the A register left 5 bits, or ADD A five times). Although not 
normally required for application programs, the directory information 
can be extracted from the buffer at this position. 



An ASCII question mark (63 decimal, 3F 
position from "fl" through "ex" matches the cor 
directory entry on the default or auto-selec 
"dr" field contains an ASCII question mark, the 
function is disabled, the giefault disk is se 
function returning any matched entry, allocated 
any user number. This latter function i 
application programs, but does allow complete f 
current directory values. If the "dr" field 
the "s2" byte is automatically zeroed. 



hexadecimal) in any 
responding field of any 
ted disk drive. If the 
n the auto disk select 
arched, with the search 
or free, belonging to 
s not normally used by 
lexibility to scan all 
is not a question mark. 



*************************************** 

* * 

* FUNCTION 18: SEARCH FOR NEXT * 

* * 

*************************************** 

* 



* Entry Parameters: 

* 

* 



* Register C: 12H J 

* Returned Value: * 

* Register A: Directory Code * 
*************************************** 



The Search Next function is similar to the Search First 
function, except that the directory scan continues from the last 
matched entry. Similar to function 17, function 18 returns the 
decimal value 255 in A when no more directory items match. 
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*************************************** 

* * 

* FUNCTION 19: DELETE FILE * 

******** ******************:*r************ 

* Entry Parameters: * 

* Register C: 13H * 

* Registers DE: FCB Address * 

* * 

* Returned Value: * 

* Register A: Directory Code * 
*************************************** 

The Delete File function removes files which match the FCB 
addressed by DE, The filename and type may contain ambiguous 
references (i.e.^ question marks in various positions), but the drive 
select code cannot be ambiguous, as in the Search and Search Next 
functions. 

Function 19 returns a decimal 255 if the referenced file or 
files cannot be found, otherwise a value in the range to 3 is 
returned. 



************** ***:»filr*********** ********* 

* * 

* FUNCTION 20: READ SEQUENTIAL * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 14H * 

* Registers DE: FCB Address * 

* * 

* Returned Value: * 

* Register A: Directory Code * 

*************************************** 

Given that the FCB addressed by DE has been activated through an 
open or make function (numbers 15 and 22) , the Read Sequential 
function reads the next 128 byte record from the file into memory at 
the current DMA address, the record is read from position "cr" of the 
extent, and the "cr" field is automatically incremented to the next 
record position. If the "cr" field overflows then the next logical 
extent is automatically opened and the '*cr" field is reset to zero in 
preparation for the next read operation. The value 00H is returned in 
the A register if the read operation was successful, while a non-zero 
value is returned if no data exists at the next record position (e,g, , 
end of file occurs). 
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FUNCTION 21: WRITE SEQUENTIAL 



* 



************************************** 

Entry Parameters: * 

Register C: 15H 

Registers DE: FCB Address 



Returned Value: 

Register A: Directory Code * 
************************************** 



Given that the FCb addressed by DE ha 
Dpen or make function (numbers 15 and 2 
lunction writes the 128 byte data record at 
:he file named by the FCB. the record is 
:he file^ and the ''cr** field is automatical 
record position. If the *'cr" field over 
extent is automatically opened and the "cr" 
^reparation for the next write operation. 
)lace into an existing file^ in which ca 
)verlay those which already exist in the f 
return from a successful write operation^ 
indicates an unsuccessful write due to a fu 



s been activated through an 

2) , the Write Sequential 

the current DMA address to 

placed at position "cr" of 

ly incremented to the next 

flows then the next logical 

field is reset to zero in 

Write operations can take 

se newly written records 

ile. Register A = 00H upon 

while a non-zero value 

11 disk. 
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k * 

^ FUNCTION 22: MAKE FILE * 

t * 

t************************************** 

^ Entry Parameters: * 

Register C: 16H 



Registers DE: FCB Address 



* 
* 
t * 

^ Returned Value: * 

^ Register A: Directory Code * 

Ir ************************************** 



The Make File operation is similar to the open file operation 
except that the FCB must name a file which does not exist in the 
:urrently referenced disk directory (i.e.^ the one named explicitly by 
a non-zero "dr" code^ or the default disk if ''dr" is zero). The FDOS 
:reates the file and initializes both the directory and main memory 
;'alue to an empty file. The programmer must ensure that no duplicate 
Eile names occur^ and a preceding delete operation is sufficient if 
:here is any possibility of duplication. Upon return, register A = 0, 
L, 2, or 3 if the operation was successful and 0FFH (255 decimal) if 
lo more directory space is available. The make function has the 
side-effect of activating the FCB and thus a subsequent open is not 
lecessary . 
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* FUNCTION 23: RENAME FILE * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 17H * 

* Registers DE: FCB Address * 

* * 

* Returned Value: * 

* Register A: Directory Code * 
*************************************** 

The Rename function uses the FCB addressed by DE to change all 
occurrences of the file named in the first 16 bytes to the file named 
in the second 16 bytes. The drive code "dr" at position is used to 
select the drive, while the drive code for the new file name at 
position 16 of the FCB is assumed to be zero. Upon return, register A 
is set to a value between and 3 if the rename was successful, and 
0FFH (255 decimal) if the first file name could not be found in the 
directory scan. 



****************^^^^^^^;it*************** 

* * 

* FUNCTION 24: RETURN LOGIN VECTOR * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 18H * 

* * 

* Returned Value: * 

* Registers HL: Login Vector * 
*************************************** 



The login vector value returned by CP/M is a 16-bit value in HL, 
where the least significant bit of L corresponds to the first drive A, 
and the high order bit of H corresponds to the sixteenth drive, 
labelled P. A "0" bit indicates that the drive is not on-line, while 
a ••1" bit marks an drive that is actively on-line due to an explicit 
disk drive selection, or an implicit drive select caused by a file 
operation which specified a non-zero "dr" field. Note that 
compatibility is maintained with earlier releases, since registers A 
and L contain the same values upon return. 
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*************************************** 

* * 

* FUNCTION 25: RETURN CURRENT DISK * 

* * 

**************************:fc**:lt********* 

* Entry Parameters: * 

* Register C: 19H * 

* * 

* Returned Value: * 

* Register A: Current Disk * 
*************************** *'* ********** 

Function 25 returns the currently selected default disk number 
in register A. The disk numbers range from through 15 corresponding 
to drives A through P. 



*************************************** 

* * 

* FUNCTION 26: SET DMA ADDRESS * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: lAH * 

* Registers DE: DMA Address * 

* * 
*************************************** 

"DMA" is an acronym for Direct Memory Address, which is often 
used in connection with disk controllers which directly access the 
memory of the mainframe computer to transfer data to and from the disk 
subsystem. Although many computer systems use non-DMA access (i.e. , 
the data is transfered through programmed I/O operations) , the DMA 
address has, in CP/M, come to mean the address at which the 128 byte 
data record resides before a disk write and after a disk read. Upon 
cold start, warm start, or disk system reset, the DMA address is 
autcxnatically set to BOOT+0080H. The Set DMA function, however, can 
be used to change this default value to address another area of memory 
where the data records reside. Thus, the DMA address becomes the 
value specified by DE until it is changed by a subsequent Set DMA 
function, cold start, warm start, or disk system reset. 



^^^ 
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*************************************** 

* * 

* FUNCTION 27: GET ADDR (ALLOC) * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: IBH * 

* * 

* Returned Value: * 

* Registers HL: ALLOC Address * 
*************************************** 

An "'allocation vector" is maintained in main memory for each 
on-line disk drive. Various system programs use the information 
provided by the allocation vector to determine the amount of remaining 
storage (see the STAT program) . Function 27 returns the base address 
of the allocation vector for the currently selected disk drive. The 
allocation information may, however, be invalid if the selected disk 
has been marked read/only. Although this function is not normally 
used by appl ication programs , additional details of the allocation 
vector are found in the "CP/M Alteration Guide." 



*************************************** 

* * 

* FUNCTION 28: WRITE PROTECT DISK * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: ICH * 

* * 

**********:Hr*****:it********************** 

The disk write protect function provides temporary write 
protection for the currently selected disk. Any attempt to write to 
the disk, before the next cold or warm start operation produces the 
message 

Bdos Err on d: R/0 



(All Information Contained Herein is Proprietary to Digital Research.) 

22 



*************************************** 

* * 

* FUNCTION 29: GET READ/ONLY VECTOR * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: IDH * 

* * 

* Returned Value: * 

* Registers HL: R/0 Vector Value* 
***********************:it*** * * ********** 

Function 29 returns a bit vector in register pair HL which 
indicates drives which have the temporary read/only bit set. Similar 
to function 24^ the least significant bit corresponds to drive A^ 
while the most significant bit corresponds to drive P. The R/0 bit is 
set either by an explicit call to function 28^ or by the automatic 
software mechanisms within CP/M which detect changed disks. 



*************************************** 

* * 

* FUNCTION 30: SET FILE ATTRIBUTES * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: lEH * 

* Registers DE: FCB Address * 

* * 

* Returned Value: * 

* Register A: Directory Code * 
*************************************** 

The Set File Attributes function allows programmatic 
manipulation of permanent indicators attached to files. In 
particular^ the R/0 and System attributes (tl* and t2*) can be set or 
reset. The DE pair addresses an unambiguous file name with the 
appropriate attributes set or reset. Function 30 searches for a 
match, and changes the matched directory entry to contain the selected 
indicators. Indicators fl* through f4' are not presently used, but 
may be useful for applications programs, since they are not involved 
in the matching process during file open and close operations. 
Indicators f5' through f8' and t3* are reserved for future system 
expansion. 
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* FUNCTION 31: GET ADDR(DISK FARMS) * 

* * 

*************************************** 

* PTn-f-K^r D a r" ain ci f- Ci K a e * 

* 
* 



Entry Parameters: 

Register C: IFH 



* Returned Value: * 

* Registers HL: DPB Address * 
*************************************** 

The address of the BIOS resident disk parameter block is 
returned in HL as a result of this function call. This address can be 
used for either of two purposes. Firsts the disk parameter values can 
be extracted for display and space computation purposes, or transient 
programs can dynamically change the values of current disk parameters 
when the disk environment changes, if required. Normally, application 
programs will not require this facility. 



*************************************** 

* * 

* FUNCTION 3 2: SET/GET USER CODE * 

* * 

*************************************** 

* 

* 

* 

* 

* 

* 

* 

* 



Entry Parameters 
Register C 
Register E 



Returned Value: 
Register A: 



* 

20H * 

0FFH (get) or * 

User Code (set) * 

* 

* 

Current Code or * 

(no value) * 
*************************************** 

An application program can change or interrogate the currently 
active user number by calling function 32. If register E = 0FFH, then 
the value of the current user number is returned in register A, where 
the value is in the range to 31. If register E is not 0FFH, then 
the current user number is changed to the value of E (modulo 32) . 
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************************************** 

* 



FUNCTION 33: READ RANDOM * 

* 

************************************** 

Entry Parameters: * 

Register C: 21H * 

Registers DE: FCB Address * 

* 

Returned Value: * 

Register A: Return Code * 

*********:Hf**************************** 



The Read Random f 
tperation of previous 
dace at a particular r 
lonstructed from the 
lositions r0 at 33^ rl 
>f 24 bits is stored 
>yte next (rl) , and hig 
2, except in computing 
lust be zero^ however, 
:he end of file. 



unction is similar to the sequential file read 
releases, except that the read operation takes 

ecord number, selected by the 24-bit value 
three byte field following the FCB (byte 

at 34, and r2 at 35). Note that the sequence 
with least significant byte first (r0) , middle 

h byte last (r2) . CP/M does not reference byte 
the size of a file (function 35) . Byte r2 
since a non-zero value indicates overflow past 



Thus, the r0,rl byte pair is treated as a double-byte, or "word" 

^alue, which contains the record to read. This value ranges from to 

i5535, providing access to any particular record of the 8 megabyte 

ile. In order to process a file using random access, the base extent 

extent 0) must first be opened. Although the base extent may or may 




Upon return from 



r0,rl), and the BDOS is called to read the record. ut^un lcl-uj-h j-^v^^i 
he call, register A either contains an error code, as listed below, 
»r the value 00 indicating the operation was successful. In the 
atter case, the current DMA address contains the randomly accessed 
ecord. Note that contrary to the sequential read operation, the 
ecord number is not advanced. Thus, subsequent random read 
operations continue to read the same record. 

Upon each random read operation, the logical extent and current 
ecord values are automatically set. Thus, the file can be 
equentially read or written, starting from the current randomly 
.ccessed position. Note, however, that in this case, the last 
andomly read record will be re-read as you switch from random mode to 
equential read, and the last record will be re-written as you switch 
o a sequential write operation. You can, of course^ simply advance 
he random record position following each random read or write to 
btain the effect of a sequential I/O operation. 



Error codes returned in register A following a random 
isted below. 



read are 
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01 reading unwritten data 

02 (not returned in random mode) 

03 cannot close current extent 

04 seek to unwritten extent 

05 (not returned in read mode) 

06 seek past physical end of disk 

Error code 01 and 04 occur when a random read operation accesses a 
data block which has not been previously written^ or an extent which 
has not been created, which are equivalent conditions. Error 3 does 
not normally occur under proper system operation, but can be cleared 
by simply re-reading, or re-opening extent zero as long as the disk is 
not physically write protected. Error code 06 occurs whenever byte r2 
is non-zero under the current 2.0 release. Normally, non-zero return 
codes can be treated as missing data, with zero return codes 
indicating operation complete. 
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* * 

* FUNCTION 34: WRITE RANDOM * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 22H * 

* Registers DE: FCB Address * 

* * 

* Returned Value: * 

* Register A: Return Code * 
*************************************** 

The Write Random operation is initiated similar to the Read 
Random, call^ except that data is written to the disk from the current 
DMA address. Further^ if the disk extent or data block which is the 
target of the write has not yet been allocated^ the allocation is 
performed before the write operation continues. As in the Read Random 
operation, the random record number is not changed as a result of the 
write. The logical extent number and current record positions of the 
file control block are set to correspond to the random record which is 
being written. Again, sequential read or write operations can 
commence following a random write, with the notation that the 
currently addressed record is either read or rewritten again as the 
sequential operation begins. You can also simply advance the random 
record position following each write to get the effect of a sequential 
write operation. Note that in particular, reading or writing the last 
record of an extent in random mode does not cause an automatic extent 
switch as it does in sequential mode. 

The error codes returned by a random write are identical to the 
random read operation with the addition of error code 05, which 
indicates that a new extent cannot be created due to directory 
overflow. 



■ 
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*************************************** 

* * 

* FUNCTION 35: COMPUTE FILE SIZE * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 23H * 

* Registers DE: FCB Address * 

* * 

* Returned Value: * 

* Random Record Field Set * 
*************************************** 

When computing the size of a f ile^ the DE register pair 
addresses an FCB in random mode format (bytes r0^ rl^ and r2 are 
present). The FCB contains an unambiguous file name which is used in 
the directory scan. Upon return, the random record bytes contain the 
••virtual" file size which is, in effect, the record address of the 
record following the end of the file. if, following a call to 
function 35, the high record byte r2 is 01, then the file contains the 
maximum record count 65536. Otherwise, bytes r0 and rl constitute a 
16~bit value (r0 is the least significant byte, as before) which is 
the file size. 

Data can be appended to the end of an existing file by simply 
calling function 35 to set the random record position to the end of 
file, then performing a sequence of random writes starting at the 
preset record address. 

The virtual size of a file corresponds to the physical size when 
the file is written sequentially. If, instead, the file was created 
in random mode and "holes" exist in the allocation, then the file may 
in fact contain fewer records than the size indicates. If, for 
example, only the last record of an eight megabyte file is written in 
random mode (i.e. , record number 65535) , then the virtual size is 
65536 records, although only one block of data is actually allocated. 
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f * 

^ FUNCTION 36: SET RANDCM RECORD * 
t * 

' Entry Parameters: * 

Register C: 24H * 

^ Registers DE: FCB Address * 

' Returned Value: * 

' Random Record Field Set * 

c ************************************** 

The Set Random Record function causes the BDOS to automatically 
produce the random record position from a file which has been read or 
/ritten sequentially to a particular point. The function can be 
iseful in two ways. 

First, it is often necessary to initially read and scan a 
sequential file to extract the positions of various "key" fields. As 
^ach key is encountered, function 36 is called to compute the random 
record position for the data corresponding to this key. If the data 
init size is 128 bytes, the resulting record position is placed into a 
:able with the key for later retrieval. After scanning the entire 
:ile and tabularizing the keys and their record numbers, you can move 
instantly to a particular keyed record by performing a random read 
ising the corresponding random record number which was saved earlier, 
[•he scheme is easily generalized when variable record lengths are 
Involved since the program need only store the buffer-relative byte 
)osition along with the key and record number in order to find the 
?xact starting position of the keyed data at a later time. 

A second use of function 36 occurs when switching from a 
sequential read or write over to random read or write. A file is 
sequentially accessed to a particular point in the file, function 36 
LS called which sets the record number, and subsequent random read and 
/rite operations continue from the selected point in the file. 
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3. A SAMPLE FILE-TO-PILE COPY PROGRAM. 

The program shown below provides a relatively simple example of 
file operations. The program source file is created as COPY. ASM using 
the CP/M ED program and then assembled using ASM or MACr resulting in 
a ''HEX" file. The LOAD program is the used to produce a C0PY.COM file 
which executes directly under the CCP. The program begins by setting 
the stack pointer to a local area^ and then proceeds to move the 
second name from the default area at 006CH to a 33-byte file control 
block called DFCB. The DFCB is then prepared for file operations by 
clearing the current record field. At this point, the source and 
destination FCB's are ready for processing since th^ SFCB at 005CH is 
properly set-up by the CCP upon entry to the COPY program. That is, 
the first name is placed into the default fcb, with the proper fields 
zeroed, including the current record field at 007CH. The program 
continues by opening the source file, deleting any exising destinatior 
file, and then creating the destination file. If all this is 
successful, the program loops at the label COPY until each record has 
been read from the source file and placed into the destination file. 
Upon completion of the data transfer, the destination file is closed 
and the program returns to the CCP command level by jumping to BOOT, 



0000 


s= 


boot 


equ 


0000h 


0005 


= 


bdos 


equ 


0005h 


005c 


= 


fcbl 


equ 


005ch 


005c 


=: 


sfcb 


equ 


fcbl 


006c 


= 


fcb2 


equ 


006ch 


0080 


=: 


dbuff 


equ 


0080h 


0100 


= 


tpa 


equ 


0100h 


0009 


sz 


7 

printf 


equ 


9 


000f 


= 


openf 


equ 


15 


0010 


= 


closef 


equ 


16 


0013 


= 


deletef 


equ 


19 


0014 


= 


readf 


equ 


20 


0015 


= 


writef 


equ 


21 


0016 


= 


makef 


equ 


22 



sample file-to-file copy program 

at the ccp level, the command 

copy a:x.y b:u.v 

copies the file named x.y from drive 
a to a file named u.v on drive b. 



system reboot 
bdos entry point 
first file name 
source fcb 
second file name 
default buffer 
beginning of tpa 

print buffer func# 
open file func# 
close file func# 
delete file func# 
sequential read 
sequential write 
make file func# 



0100 

0100 311b02 



0103 0el0 



org 
Ixi 

move 
mvi 



tpa ; beginning of tpa 
sp, stack; local stack 

second file name to dfcb 
c,16 ; half an fcb 



(All Information Contained Herein is Proprietary to Digital Research, 

30 



0105 
0108 
010b 
010c 
010d 
010e 
010f 
0110 



116C00 

21da01 

la 

13 

11 

23 

0d 

c20b01 



mf cb: 



0113 af 

0114 32fa01 



source of move 
destination fcb 
source fcb 
ready next 
dest fcb 
ready next 
count 16. . .0 
loop 16 times 



name has been moved, zero cr 

xra a ; a = 00h 

sta dfcbcr ; current rec = 

source and destination fob's ready 



Ixi 


d,fcb2 


Ixi 


h.dfcb 


Idax 


d 


inx 


d 


mov 


m^a 


inx 


h 


dcr 


c 


jnz 


mf cb 



0117 
011a 
011d 
0120 
0121 



115C00 

cd6901 

118701 

3c 

CC6101 



Ixi 


d.sfcb ; 


' source file 


call 


open , 


? error if 255 


Ixi 


d^nof ile, 


] ready message 


inr 


a ; 


' 255 becomes 


cz 


finis ; 


' done if no file 



0124 llda01 
0127 cd7301 



source file open, pi^ep destination 

Ixi d^dfcb ; destination 

call delete ; remove if present 



012a 


llda01 


Ixi 


d,dfcb ; 


destination 


012d 


cd8201 


call 


make ; 


create the file 


0130 


119601 


Ixi 


d,nodir ; 


ready message 


0133 


3c 


inr 


a ; 


2 55 becomes 


0134 


CC6101 


cz 


finis ; 


done if no dir space 



source file open, dest file open 
copy until end of file on source 



0137 


115C00 


c 


opy: 


Ixi 


d,sfcb ; 


source 


013a 


cd7801 






call 


read ; 


• read next record 


013d 


b7 






ora 


a ; 


end of file? 


013e 


C25101 






jnz 


eofile ; 


• skip write if so 






7 

• 
/ 




not end 


of file. 


write the record 


0141 


llda01 






Ixi 


d,dfcb 


', destination 


0144 


cd7d01 






call 


write , 


; write record 


0147 


lla901 






Ixi 


d, space 


\ ready message 


014a 


b7 






ora 


a 


) 00 if write ok 


014b 


C46101 






cnz 


finis 


; end if so 


014e 


C33701 


• 




jmp 


copy 


? loop until eof 






1 

e 


of ile: 


; end o 


f file, c; 


Lose destination 


0151 


llda01 






Ixi 


d,dfcb 


; destination 


0154 


cd6e01 






call 


close 


; 255 if error 


0157 


21bb01 






Ixi 


h,wrprot 


; ready message 


015a 


3c 






inr 


a , 


; 255 becomes 00 


015b 


CC6101 






cz 


finis 


', shouldn't happen 



Append! 

F 



copy operation complete, end 
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015e 11CC01 



Ixi 



d, normal; ready message 



finis: 



0161 0e09 
0163 cd0500 
0166 C30000 



0169 0e0f open: 
016b C30500 

016e 0el0 close: 

0170 C30500 

• 

0173 0el3 delete: 
0175 C30500 

0178 0el4 read: 
017a C30500 

• 

017d 0el5 write: 
017f C30500 

• 

0182 0el6 make: 
0184 C30500 



0187 6e6f20fnof ile: 
0196 6e6f209nodir: 
01a9 6f7574fspace: 
01bb 7772695wrprot: 
01cc 636f 700normal: 



; write message given by de^ reboot 
mvi c^printf 
call bdos ; write message 
jmp boot ; reboot system 

system interface subroutines 
(all return directly from bdos) 



mvi 
jmp 

mvi 
jmp 

mvi 
jmp 

mvi 
jmp 

mvi 
jnip 

mvi 
jmp 



01da 
01fa = 

01fb 
021b 



dfcb: 
dfcbcr 



stack; 



c^openf 
bdos 

CrClosef 
bdos 

c^deletef 
bdos 

c^readf 
bdos 

c^wr itef 
bdos 

cmakef 
bdos 



console messages 

db 'no source file$* 

db 'no directory space$ ' 

db 'out of data space$' 

db 'write protected?$' 

db 'copy complete?' 

data areas 

ds 33 ; destination fcb 

equ dfcb+32 ; current record 



ds 
end 



32 



; 16 level stack 



Note that there are several simplificat 
program. First, there are no checks fo 
could, for example, contain ambiguous refe 
could be detected by scanning the 32 byt 
location 005CH for ASCII question marks. A 
to ensure that the file names have, in 
locations 005DH and 006DH for non-blank ASCI 
check should be made to ensure that the sour 
names are different. A speed improvement 
more data on each read operation. One could 



ions in this particular 
r invalid file names which 
rences. This situation 
e default area starting at 
check should also be made 
fact, been included (check 
I characters). Finally, a 
ce and destination file 
could be made by buffering 
for example, determine 



(All Inform.ation Contained Herein is Proprietary to Digital Research.) 

32 



the ^ size of memory by fetching FBASE from location 0006H and use the 
entire remaining portion of memory for a data buffer. In this case, 
the programmer simply resets the DMA address to the next successive 
128 byte area before each read. Upon writing to the destination file, 
the DMA address is reset to the beginning of the buffer and 
incremented by 128 bytes to the end as each record is transferred to 
the destination file. 



Append! 
F 
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4. A SAMPLE FILE DUMP UTILITY. 



The file dump program shown below is slightly more complex than 
the simple copy program given in the previous section. The dump 
program reads an input file^ specified in the CCP command line^ and 
displays the content of each record in hexadecimal format at the 
console. Note that the dump program saves the CCP's stack upon entry, 
resets the stack to a local area, and restores the CCP's stack before 
returning directly to the CCP. Thus, the dump program does not 
perform and warm start at the end of processing. 



0100 
0005 = 

0001 = 

0002 = 
0009 = 

000b = 
000f = 
0014 = 

5c = 
0080 = 



0d = 
000a = 



005c 
005d 
0065 
0068 
6b 
7c 
007d 



DUMP program reads input file and displays hex data 



bdos 
cons 
typef 
pr mtf 

brkf 

openf 

readf 

• 

fcb 
buff 



cr 
If 



fcbdn 
fcbfn 
fcbft 
fcbrl 
fcbrc 
fcbcr 
fcbln 



0100 210000 

0103 39 

0104 221502 
0107 315702 

010a cdcl01 
010d feff 
010f c21b01 



0112 llf301 
0115 cd9c01 
0118 C35101 



org 
egu 
equ 
egu 
equ 
equ 
equ 
equ 

equ 
equ 



100h 

0005h 

1 
2 

9 

11 
15 
20 

5ch 
80h 



;dos entry point 

;read console 
; type function 

;buffer print entry 
;break key function 
;file open 

;read function 



(true if char 



;file control block address 
;input disk buffer address 



non graphic characters 

equ 0dh ;carriage return 

equ 0ah ;line feed 

file control block definitions 



equ 
equ 
equ 
equ 
equ 
equ 
equ 



fcb+0 
fcb+1 
fcb+9 
fcb+1 2 
fcb+1 5 
fcb+3 2 
fcb+3 3 



disk name 

file name 

disk file type (3 characters) 

file's current reel number 

file's record count (0 to 128) 

current (next) record number (0 

fcb length 



set up stack 

Ixi h,0 

dad sp 

entry stack pointer in hi from the ccp 

shld oldsp 

set sp to local stack area (restored at finis) 

Ixi sp,stktop 

read and print successive buffers 

call setup ;set up input file 

cpi 255 ;255 if file not present 

jnz openok ;skip if open is ok 

file not there, give error message and return 

Ixi d,opnmsg 

call 

jmp 



err 
finis 



;to return 
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011b 3e80 
011d 321302 

0120 210000 



openok; 



0123 e5 

0124 cda201 

0127 el 

0128 da5101 
012b 47 



012c 7d 
012d e60f 
012f C24401 

0132 cd7201 



0135 cd5901 

0138 0f 

0139 da5101 

013c 7c 
013d cd8f01 

0140 7d 

0141 cd8f01 

0144 23 

0145 3e20 
0147 cd6501 
014a 78 
014b cd8f01 
014e C32301 



gloop: 



nonum: 



finis: 



0151 cd7201 
0154 2al502 

0157 f9 

0158 c9 



;open operation ok^ set buffer index to end 

mvi a^80h 

sta ibp ;set buffer pointer to 80h 

hi contains next address to print 

Ixi h,0 ;start with 0000 



push 
call 
pop 

jc 
mov 



;save line position 



;recall line position 

;carrY set by gnb if end file 



h 

gnb 

h 

finis 

b,a 

print hex values 
check for line fold 
mov a , 1 

ani 0fh ;check low 4 bits 
jnz nonum 
print line number 
call crlf 

check for break key 

call break 

accum Isb = 1 if character ready 

rrc ; into carry 

jc finis ;don't print any more 



mov 
call 
mov 
call 

inx 

mvi 

call 

mov 

call 

jmp 



a,h 

phex 

a,l 
phex 

h 
a,' • 

pchar 
a^b 
phex 
gloop 



; to next line number 



end of dump^ return to ccp 
(note that a jmp to 0000h reboots) 
call crlf 
Ihld oldsp 
sphl 
stack pointer contains ccp's stack location 

ret ;to the ccp 



0159 e5d5c5 
015c 0e0b 
015e cd0500 
0161 cldlel 



; subroutines 

break: ;check break key (actually any key will do) 
push h! push d! push b; environment saved 
mvi c^brkf 
call bdos 
pop b! pop d! pop h; environment restored 



Append! 

F I 
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0164 c9 



ret 



pchar: ;print a character 

0165 e5d5c5 push h! push dl push b; saved 

0168 0602 mvi c,typef 

016a 5f mov e,a 

016b cd0500 call bdos 

016e cldlel pop b! pop d! pop h; restored 

0171 c9 ret 



crlf ; 



0172 
0174 
0177 
0179 
017c 



3e0d 

cd6501 

3e0a 

cd6501 

c9 



mvi 

call 

mvi 

call 

ret 



a,cr 
pchar 
a, If 
pchar 



pnib; 



017d e60f 
017f fe0a 
0181 d28901 

0184 c630 
0186 c38b01 



0189 c637 pl0i 
018b cd6501 prn: 
018e c9 



;print nibble in reg 

;low 



am 

cpi 

jnc 

less 

adi 

jmp 



0fh 
10 
pl0 
than or equal to 
.0. 

prn 



bits 



greater or 
adi 
call 
ret 



equal 
a' - 10 
pchar 



to 10 



018f 
0190 
0191 
0192 
0193 
0194 
0197 
0198 
019b 



f5 

0f 

0f 

0f 

0f 

cd7d01 

fl 

cd7d01 

c9 



phex: ;print hex char in reg a 



push 

rrc 

rrc 

rrc 

rrc 

call 

pop 

call 

ret 



psw 



pnib 

psw 

pnib 



;print nibble 



019c 0e09 
019e cd0500 
01al c9 



err: ;print error message 

; d,e addresses message ending with "$" 

mvi cprintf ;print buffer function 

call bdos 

ret 



01a2 3al302 
01a5 fe80 
01a7 c2b301 



gnb: 



;get 


next byte 


Ida 


ibp 


cpi 


80h 


jnz 


g0 


read 


another buffer 
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01aa 
01ad 
01ae 


cdce01 

b7 

cab301 




01bl 
01b2 


37 
c9 


• 


01b3 
01b4 

01b6 
01b7 


5f 

1600 
3c 
321302 


g0: 

• 


01ba 
01bd 


218000 
19 


• 
• 


01be 


7e 


• 


01bf 
01c0 


b7 
c9 


• 

setup 


01cl 
01c2 


af 
327C00 


7 


01c5 
01c8 
01ca 


115C00 

0e0£ 

cd0500 


# 


01cd 


c9 


/ 


01ce 
01dl 
01d4 
01d6 
01d9 
01dc 


e5d5c5 

115C00 

0el4 

cd0500 

cldlel 

c9 


diskr 



call diskr 

ora a ;zero value if read ok 

jz g0 ;for another byte 

end of data^ return with carry set for eof 

stc 

ret 

;read the byte at buff+reg a 

mov e^a ;ls byte of buffer index 

mvi d^0 ;double precision index to de 

inr a ; index=index+l 

sta ibp ;back to memory 

pointer is incremented 

save the current file address 

Ixi h^buff 

dad d 

absolute character address is in hi 

mov a^m 

byte is in the accumulator 

ora a ;reset carry bit 

ret 

;set up file 

open the file for input 

xra a ;zero to accum 

sta fcbcr ;clear current record 

Ixi d^fcb 

mvi c^openf 

call bdos 

255 in accum if open error 

ret 

;read disk file record 

push h! push d! push b 

Ixi d^fcb 

mvi c^^readf 

call bdos 

pop b! pop d! pop h 

ret 



; fixed message area 
01dd 46494c0signon: db 'file dump version 2.0$' 
01f3 0d0a4e0opnmsg: db cr.lf^'no input file present on disk$* 



0213 
0215 



0217 
0257 



; variable area 
ibp: ds 2 
oldsp: ds 2 



stktop: 



stack area 
ds 64 



end 



; input buffer pointer 
; entry sp value from ccp 



; reserve 32 level stack 
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5. A SAMPLE RANDOM ACCESS PROGRAM. 

This manual is concluded with a rather extensive^ but complete 
example of randan access operation. The program listed below performs 
the simple function of reading or writing random records upon command 
from the terminal. Given that the program has been created^ 

assembled^ and placed into a file labelled RANDOM. COM^ the CCP level 
command: 

RANDOM X.DAT 

starts the test program. The program looks for a file by the name 
X.DAT (in this particular case) and^ if founds proceeds to prompt the 
console for input. If not found, the file is created before the 
prompt is given. Each prompt takes the form 

next command? 

and is followed by operator input, terminated by a carriage return. 
The input Commands take the form 

nW nR Q 

where n is an integer value in the range to 65535, and W, R, and Q 
are simple command characters corresponding to random write, random 
read, and quit processing, respectively. If the W command is issued, 
the RANDOM program issues the prompt 

type data: 

The operator then responds by typing up to 127 characters, followed by 
a carriage return. RANDOM then writes the character string into the 
X.DAT file at record n. If the R command is issued, RANDOM reads 
record number n and displays the string value at the console. If the 
Q command is issued, the X.DAT file is closed, and the program returns 
to the console command processor. In the interest of brevity, the 
only error message is 

error, try again 

The program begins with an initialization section where the 
input file is opened or created, followed by a continuous loop at the 
label "ready" where the individual commands are interpreted. The 
default file control block at 005CH and the default buffer at 0080H 
are used in all disk operations. The utility subroutines then follow, 
which contain the principal input line processor, called "readc." 
This particular program shows the elements of random access 
processing, and can be used as the basis for further program 
development. 
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. ********************** 
» * 






;* sample ra 
» * 


ndom access 






, ********************** 


0100 


, 




org 


100h 


0000 


r 

= reboot 


equ 


00h 


0005 


bdos 


equ 


0005h 


0001 


= coninp 


equ 


1 


0002 


= conout 


equ 


2 


0009 


pstring 


equ 


9 


000a 


= rstring 


equ 


10 


000c 


version 


equ 


12 


000f 


= openf 


equ 


15 


0010 


= closef 


equ 


16 


0016 


= makef 


equ 


22 


0021 


= readr 


equ 


33 


0022 


= writer 


equ 


34 


5c 


] 


:cb 


equ 


005ch 


007d 


] 


canrec 


equ 


fcb+3 3 


007f 


= ] 


canovf 


equ 


fcb+35 


0080 


buff 


equ 


0080h 


000d 


= ( 


2r 


equ 


0dh 


000a 


= 


If 


equ 


0ah 



***************************** 

* 
* 
* 

***************************** 

;base of tpa 



program for cp/m 2.0 



0100 31bc0 



0103 


0e0c 




0105 


cd050 




0108 


fe20 




010a 


d2160 




010d 


lllb0 


/ 


0110 


cdda0 




0113 


C3000 


• 

versok 


0116 


0e0f 


/ 


0118 


115c0 




011b 


cd050 




011e 


3c 




011f 


C2370 





;system reboot 
;bdos entry point 

console input function 
console output function 
print string until •$' 
read console buffer 
return version number 
file open function 
close function 
make file function 
read random 
write random 

;default file control block 
;random record position 
;high order (overflow) byte 
;buffer address 

;carriage return 
;line feed 



*************************************************** 

* * 

* load SP^ set-up file for random access * 

* * 
*************************************************** 

Ixi sp^stack 

version 2.0? 

mvi c, version 

call bdos 

cpi 20h ;version 2.0 or better? 

jnc versok 

bad version, message and go back 

Ixi d.badver 

call print 

jmp reboot 



correct version for random access 

mvi c, openf ;open default fcb 

Ixi d^fcb 

call bdos 

inr a ;err 255 becomes zero 

jnz ready 

cannot open f ile^ so create it 
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0122 0el6 
0124 115C0 
0127 cd050 
012a 3c 
012b C2370 



012e 113a0 
0131 cdda0 
0134 C3000 



0156 fe57 
0158 C2890 



015b 114d0 

015e cdda0 

0161 0e7f 

0163 21800 

0166 c5 

0167 e5 

0168 cdc20 
016b el 



mvi c,makef 

Ixi d,fcb 

call bdos 

inr a ;err 255 becomes zero 

jnz ready 

cannot create file, directory full 

Ixi d,nospace 

call print 

jmp reboot ;back to ccp 

*************************************************** 

* * 

* loop back to "ready" after each command * 

* * 
*************************************************** 



ready: 

; file is ready for processing 

• 

readcom ;read next command 
ranrec ;store input record# 
h^ranovf 

m^0 ;clear high byte if set 
■Q' ?quit? 
notq 

quit processing^ close file 
c^closef 
d.fcb 
bdos 

a ;err 255 becomes 
error ;error message^ retry 
reboot ;back to ccp 

* end of quit command, process write * 

* * 
****************************************** 

notq: 

; not the quit command, random write? 

cpi 'W 

jnz notw 

; this is a random write, fill buffer until cr 
Ixi d,datmsg 
call print ;data prompt 
mvi c,127 ;up to 127 characters 
Ixi h,buff ;destination 

rloop: ;read next character to buff 
push b ;save counter 
push h ;next destination 
call getchr ;character to a 
pop h ;restore counter 



0137 


cde50 


call 


013a 


2 27d0 


shld 


013d 


217f0 


Ixi 


0140 


3600 


mvi 


0142 


fe51 


cpi 


0144 


C2560 


jnz 




• 


quit 


0147 


0el0 


mvi 


0149 


115C0 


Ixi 


014c 


cd050 


call 


014f 


3c 


inr 


0150 


cab90 


jz 


0153 


c3000 


jmp 
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016c cl 
016d fe0dl 
016f ca780 

0172 77 

0173 23 

0174 0d 

0175 C2660 



0178 3600 



017a 0e22 
017c 115C0 
017f cd050 

0182 b7 

0183 c2b90 
0186 C3370 



erloop: 



0189 


fe52 


018b 


c2b90 


018e 


0e21 


0190 


115C0 


0193 


cd050 


0196 


b7 


0197 


c2b90 


019a 


cdcf0 


019d 


0e80 


019f 


21800 


01a2 


7e 


01a3 


23 


01a4 


e67f 


01a6 


ca370 


01a9 


c5 


01aa 


e5 


01ab 


fe20 


01ad 


d4c80 


01b0 


el 


01bl 


cl 


01b2 


0d 


01b3 


c2a20 


01b6 


C3370 



pop b ;restore next to fill 

cpi cr ;end of line? 

jz erloop 

not end, store character 

mov m^a 

inx h ;next to fill 

dcr c ;counter goes down 

jnz rloop ;end of buffer? 

end of read loop, store 00 
mvi m,0 

write the record to selected record number 

mvi c, writer 

Ixi d,fcb 

call bdos 

ora a ;error code zero? 

jnz error ;message if not 

jmp ready ;for another record 

* * 

* end of write command, process read * 

*************************************************** 
notw: 
; not a write command, read record? 

cpi 'R' 

jnz error ;skip if not 

; read random record 
mvi c,readr 
Ixi d,fcb 
call bdos 

ora a ;return code 00? 
jnz error 

; read was successful, write to console 
call crlf ;new line 
mvi c,128 ;max 128 characters 
Ixi h,buff ;next to get 



wloop: 



mov 
inx 
ani 

jz 
push 

push 

cpi 

cnc 

pop 

pop 

dcr 

jnz 

jmp 



a,m 

h 

7fh 

ready 

b 

h 
I I 



;next character 

;next to get 

;mask parity 

;for another command if 00 

;save counter 

;save next to get 

;graphic? 
putchr ;skip output if not 
h 
b 
c 

wloop 
ready 



Append! 

F I 



;count=count-l 
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01b9 11590 

01bc cdda0 
01bf C3370 



*************************************************** 

* end of read command^ all errors end-up here * 

* * 

*************************************************** 



error: 

Ixi d^errmsg 

call print 
jmp ready 

* * 

* utility subroutines for console i/o * 

• • 

*************************************************** 



getchr ; 



01c2 0e01 
01c4 cd050 
01c7 c9 



;read next console character to a 

mvi c^coninp 

call bdos 
ret 



putchr: 



01c8 0e02 

01ca 5f 

01cb cd050 

01ce c9 



;write character from a to console 

mvi c^conout 

mov e,a ;character to send 

call bdos ;send character 

ret 



crlf ; 



01cf 3e0d 

01dl cdc80 

01d4 3e0a 

01d6 cdc80 

01d9 c9 



;send carriage return line feed 

mvi a^cr ;carriage return 

call putchr 

mvi a/If ;line feed 

call putchr 

ret 



print: 



01da d5 
01db cdcf0 
01de dl 
01df 0e09 
01el cd050 
01e4 c9 



;print the buffer addressed by de until $ 

push d 

call crlf 

pop d ;new line 

mvi c^pstring 

call bc3os ;print the string 

ret 



r e ad c om : 



01e5 116b0 
01e8 cdda0 
01eb 0e0a 
01ed 117a0 
01f0 cd050 



;read the next command line to the conbuf 

Ixi d^prompt 

call print ;command? 

mvi c,r string 

Ixi d^conbuf 

call bdos ;read command line 

command line is present^ scan it 
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01f3 
01f6 
01f9 
01fa 
01fb 
01fc 

01fd 
01ff 
0201 

0204 
0205 
0206 
0207 
0208 
0209 
020a 
020b 
020c 
20f 
0210 



0213 
0215 
0217 

0218 
21a 



21000 

117C0 

la 

13 

57 

c8 

d630 
fe0a 
d2130 

29 

4d 

44 

29 

29 

09 

85 

6f 

d2f90 

24 

C3f90 



C630 
fe61 
d8 

e65f 
c9 



Ixi 
Ixi 
readc: Idax 
inx 



endrd: 

I 



h,0 ;start with 0000 
d^conlin;command line 
d ;next command character 
d ; to next command position 
a ; cannot be end of command 



ora 

rz 

not zero, numeric? 

sui '0' 

cpi 10 ;carry if numeric 

jnc endrd 

add-in next digit 

dad h ;*2 

c.l 

;bc = value * 2 

;*4 

;*8 

;*2 + *8 = *10 

;+digit 



mov 
mov 
dad 
dad 
dad 
add 
mov 
jnc 
inr 
jmp 



b,h 

h 

h 

b 

1 

l.a 

readc 

h 

readc 



;for another char 

; overflow 

;for another char 



end of read, restore value in a 

adi '0' ; command 

cpi *a' ;translate case? 

re 

lower case^ mask lower case bits 

ani 101$llllb 

ret 



021b 
23a 
024d 
0259 
026b 



536f79 



*************************************************** 

*************************************************** 

badver : 

*sorry, you need cp/m version 2$' 



* string data area for console messages 
* 



db 



nospace: 
4e6f29 db 

datmsg : 
547970 db 

errmsg : 
457272 db 

prompt: 
4e6570 db 



*no directory space$ ' 
•type data: $' 
'error, try again. $• 
•next command? $' 
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027a 21 


conbuf : 


db 


027b 


consiz: 


ds 


027c 


conlin: 


ds 


0021 = 


conlen 


equ 


029c 


7 

Stack: 


ds 


02bc 




end 



*************************************************** 

* * 

* fixed and variable data area * 

* * 

*************************************************** 

conlen ;length of console buffer 

1 ;resulting size after read 

32 ;length 32 buffer 
$-consiz 

32 ;16 level stack 



Again, major improvements could be made to this particular 
program to enhance its operation. In fact, with some work, this 
program could evolve into a simple data base management system. One 
could, for example, assume a standard record size of 128 bytes, 
consisting of arbitrary fields within the record, A program, called 
GETKEY, could be developed which first reads a sequential file and 
extracts a specific field defined by the operator. For example, the 
command 

GETKEY NAMES.DAT LASTNAME 10 20 

would cause GETKEY to read the data base file NAMES, DAT and extract 
the "LASTNAME" field from each record, starting at position 10 and 
ending at character 20, GETKEY builds a table in memory consisting of 
each particular LASTNAME field, along with its 16-bit record number 
location within the file. The GETKEY program then sorts this list, 
and writes a new file, called LASTNAME, KEY, which is an alphabetical 
list of LASTNAME fields with their corresponding record numbers. 
(This list is called an "inverted index" in information retrieval 

parlance, ) 

Rename the program shown above as QUERY, and massage it a bit so 
that it reads a sorted key file into memory. The command line might 
appear as: 

QUERY NAMES.DAT LASTNAME, KEY 

Instead of reading a number, the QUERY program reads an alphanumeric 
string which is a particular key to find in the NAMES, DAT data base. 
Since the LASTNAME. KEY list is sorted, you can find a particular entry 
quite rapidly by performing a "binary search," similar to looking up a 
name in the telephone book. That is, starting at both ends of the 
list, you examine the entry halfway in between and, if not matched, 
split either the upper half or the lower half for the next search. 
You'll quickly reach the item you're looking for (in log2(n) steps) 
where you'll find the corresponding record number. Fetch and display 
this record at the console, just as we have done in the program shown 
above. 
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At this point you're just getting started. With a little more 
work^ you can allow a fixed grouping size which differs from the 128 
byte record shown above. This is accomplished by keeping track of the 
record number as well as the byte offset within the record. Knowing 
the group size, you randomly access the record containing the proper 
group, offset to the beginning of the group within the record read 
sequentially until the group size has been exhausted. 

Finally, you can improve QUERY considerably by allowing boolean 
expressions which compute the set of records which satisfy several 
relationships, such as a LASTNAME between HARDY and LAUREL, and an AGE 
less than 45. Display all the records which fit this description. 
Finally, if your lists are getting too big to fit into memory, 
randomly access your key files from the disk as well. One note of 
consolation after all this work: if you make it through the project, 
you'll have no more need for this manual! 



Append 
F 
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SYSTEM FUNCTION SUMMARY. 



FUNC FUNCTION NAME 



INPUT PARAMETERS OUTPUT RESULTS 






System Reset 


none 




none 


1 


Console Input 


none 




A = 


char 


2 


Console Output 


E = c 


har 


none 


3 


Reader Input 


none 




A = 


char 


4 


Punch Output 


E = c 


har 


none 


5 


List Output 


E = c 


har 


none 


6 


Direct Console I/O 


see d 


ef 


see 


def 


7 


Get I/O Byte 


none 




A = 


lOBYTE 


8 


Set I/O Byte 


E = lOBYTE 


none 


9 


Print String 


DE = 


.Buffer 


none 


10 


Read Console Buffer 


DE = 


.Buffer 


see 


def 


11 


Get Console Status 


none 




A = 


00/FF 


12 


Return Version Number 


none 




HL= 


Version* 


13 


Reset Disk System 


none 




see 


def 


14 


Select Disk 


E = Disk Number 


see 


def 


15 


Open File 


DE = 


.FCB 


A = 


Dir Code 


16 


Close File 


DE = 


.FCB 


A = 


Dir Code 


17 


Search for First 


DE = 


.FCB 


A = 


Dir Code 


18 


Search for Next 


none 




A = 


Dir Code 


19 


Delete File 


DE = 


.FCB 


A = 


Dir Code 


20 


Read Sequential 


DE = 


.FCB 


A = 


Err Code 


21 


Write Sequential 


DE = 


.FCB 


A = 


Err Code 


22 


Make File 


DE = 


.FCB 


A = 


Dir Code 


23 


Rename File 


DE = 


.FCB 


A = 


Dir Code 


24 


Return Login Vector 


none 




HL= 


Login Vect* 


25 


Return Current Disk 


none 




A = 


Cur Disk# 


26 


Set DMA Address 


DE = 


.DMA 


none 


27 


Get Addr (Alloc) 


none 




HL= 


.Alloc 


28 


Write Protect Disk 


none 




see 


def 


29 


Get R/0 Vector 


none 




HL= 


R/0 Vect* 


30 


Set File Attributes 


DE = 


.FCB 


see 


def 


31 


Get Addr (disk parms) 


none 




HL= 


.DPB 


32 


Set/Get User Code 


see d 


lef 


see 


def 


33 


Read Random 


DE = 


.FCB 


A = 


Err Code 


34 


Write Random 


DE = 


.FCB 


A = 


Err Code 


35 


Compute File Size 


DE = 


.FCB 


r0. 


rl, r2 


36 


Set Random Record 


DE = 


,FCB 


r0. 


rl, r2 



* Note that A = L^ and B = H upon return 



(All Information Contained Herein is Proprietary to Digital Research.) 

46 



APPENDIX G 



THE CP/M 2.0 
SYSTEM ALTERATION GUIDE 



Append 
G 



)st Office Box 579, Pacific Grove, California 93950, (408) 649-3896 



CP/M 2.0 ALTERATION GUIDE 



Copyright (c) 1979 
DIGITAL RESEARCH 



Appendix 
G 



Copyright 

Copyright (c) 1979 by Digital Research. AH rights reserved. 
No part of this publication may be reproduced, transmitted, 
transcribed, stored in a retrieval system, or translated into 
any language or computer language, in any form or by any 
means, electronic, mechanical, magnetic, optical, chemical, 
manual or otherwise, without the prior written permission of 
Digital Research, Post Office Box 579, Pacific Grove, 
California 93950. 

Disclaimer 



Digital Research makes no representations or warranties with 
respect to the contents hereof and specifically disclaims any 
implied warranties of merchantability or fitness for any parti- 
cular purpose. Further, Digital Research reserves the right 
to revise this publication and to make changes from time to 
time in the content hereof without obligation of Digital 
Research to notify any person of such revision or changes. 

Trademarks 

CP/M is a registered trademark of Digital Research. MP/M, 
MAC, and SID are trademarks of Digital Research. 
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1. INTRODUCTION 

The standard CP/M system assumes operation on an Intel MDS-800 
microcomputer development system, but is designed so that the user can 
alter a specific set of subroutines which define the hardware 
operating environment. In this way, the user can produce a diskette 
which operates with any IBM-3741 format compatible drive controller 
and other peripheral devices. 



Altnough standard CP/M 2.0 is configured for 
disks, field-alteration features allow adaptatio 
disk subsystems from single drive minidisks 
"hard disk" systems. In order to simplify th 
process, we assume that CP/M 2.0 will first be c 
density floppy disks where minimal editing a 
available. If an earlier version of CP/ 
customizing process is eased considerably. In t 
may. wisn to briefly review the system generatio 
later sections which discuss system alteration f 
systems. 



single density floppy 
n to a wide variety of 
through high-capacity 
e following adaptation 
onfigured for single 
nd debugging tools are 
M is available, the 
his latter case, you 
n process, and skip to 
or non-standard disk 



In order to achieve device independence, CP/M is separated into 
tnree distinct modules: 

BIOS - basic I/O system which is environiaent dependent 
BDOS - basic disk operating system v;hich is not dependent 

upon the hardware configuration 
CCP - the console command processor which uses the BDOS 

Of these modules, only the BIOS is dependent upon the particular 
Hardware. That is, the user can "patch" the distribution version of 
CP/M to provide a new BIOS which provides a customized interface 
between the remaining CP/M modules and the user's own hardware system. 
The purpose of this document is to provide a step-by-step procedure 
for patching your new BIOS into CP/M. 

If CP/M is being tailored to your computer system for the first 
time, the new BIOS requires some relatively simple software 
development and testing. The standard BIOS is listed in Appendix B, 
and can be used as a model for the customized package. A skeletal 
version of the BIOS is given in Appendix C which can serve as the 
basis for a modified BIOS. In addition to the BIOS, the user must 
write a simple memory loader, called GETSYS, which brings the 
operating system into memory. In order to paten the new BIOS into 
CP/M, the user must write the reverse of GETSYS, called PUTSYS, which 
places an altered version of CP/M back onto the diskette. PUTSYS can 
be derived from GETSYS by changing the disk read commands into disk 
write commands. Sample skeletal GETSYS and PUTSYS programs are 
described in Section 3, and listed in Appendix D. In order to make 
the CP/M system work automatically, the user must also supply a cold 
start loader, similar to the one provided with CP/M (listed in 
Appendices A and B) . A skeletal form of a cold start loader is given 
in Appendix E which can serve as a model for your loader. 
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2. FIRST LEVEL SYSTEM REGENERATION 

The procedure to follow to paten the CP/M system is given below in 
several steps. Address references in each step are shown with a 
following "H" which denotes the hexadecimal radix, and are given for a 
20K CP/M system. For larger CP/M systems, add a "bias" to each 
address which is shown with a "+b" following it, where b is equal to 
tne memory size - 20K. Values for b in various standard memory sizes 
are 



24K: 


b = 24K - 


20K = 


4K = 


1000H 


32K! 


; b = 32K - 


20K = 


12K = 


3000H 


40K 


: b = 40K - 


20K = 


20K = 


5000H 


48K 


: b = 48K - 


2 0K = 


28K = 


7000H 


56K 


! b = 56K - 


20K = 


36K = 


9000H 


62K: 


: b = 62K - 


20K = 


42K = 


A800H 


64K 


: b = 64K - 


20K = 


44K = 


B000H 



Note: The standard distribution version of CP/M is set f or ^ 
operation within a 20K memory system. Therefore, you must first bring 
up the 20K CP/M system, and then configure it for your actual memory 
size (see Second Level System Generation) . 

(1) Review Section 4 and write a GETSYS program which reads the 
first two tracks of a diskette into memory. The data from the diskette 
must begin at location 3380H. Code GETSYS so that it starts at 
location 100ri (oase of the TPA) , as shown in the first part of 
Appendix d. 

(2) Test tne GETSYS program by reading a blank diskette into 
memory, and check to see that the data has been read properly, and 
that the diskette has not been altered in any way by the GETSYS 
program. 

(3) Run the GETSYS program using an initialized CP/M diskette to 
see if GETSYS loads CP/M starting at 3380H (the operating system 
actually starts 128 bytes later at 3400H) . 

(4) Review Section 4 and write the PUTSYS program which writes 
memory starting at 3380ri back onto the first two tracks of the 
diskette. The PUTSYS program should be located at 200H, as shown in 
the second part of Appendix D. 



(5) Test the PUTSYS program using a blank uninitialized diskette 
by writing a portion of memory to the first two tracks; clear memory 
and read it back using GETSYS. Test PUTSYS completely, since this 
program will be used to alter CP/M on disk. 



Study Sections 5, 6, and 7, along with the distribution 



input/output 



(6) . , , , . 

version of the BIOS given in Appendix B, and write a simple version 
which performs a similar function for the customized environment. Use 
the program given in Appendix C as a model. Call this new BIOS by the 
name CBIOS (customized BIOS). Implement only the primitive disk 
operations on a single drive, and simple console 
functions in this phase. 
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(7) Test CBIOS completely to ensure that it properly performs 
console character I/O and disk reads and writes. Be especially 
careful to ensure that no disk write operations occur accidently 
during read operations, and check that the proper track and sectors 
are addressed on all reads and writes. Failure to make these checks 
may cause destruction of the initialized CP/i^ system after it is 
patched. 

(3) Referring to Figure 1 in Section 5, note that the BIOS is 
placed between locations 4A00H and 4FFFH. Read the CP/M system using 
GETSYS and replace the BIOS segment by the new CBIOS developed in step 
(6) and tested in step (7). This replacement is done in the memory of 
the machine, and will be placed on the diskette in the next step. 

(9) Use PUTSYS to place the patched memory image of CP/M onto the 
first two tracks of a blank diskette for testing. 

(10) Use GETSYS to bring the copied memory image from the test 
diskette back into memory at 3380H, and check to ensure that it has 
loaded back properly (clear memory, if possible, before the load). 
Upon successful load, brancn to the cold start code at location 4A00H. 
The cold start routine will initialize page zero, then jump to the CCP 
at location 3400H which will call the BDOS, which will call the CBIOS. 
The CBIOS will be asked by the CCP to read sixteen sectors on track 2, 
and if successful, CP/M will type "A>", the system prompt. 

When you make it this far, you are almost on tne air. If you have 
trouble, use whatever debug facilities you have available to trace and 
breakpoint your CBIOS. 

(11) Upon completion of step (10) , CP/M has promoted the console 
for a command input. Test the disk write operation by typing 

SAVE 1 X.COM 
(recall that all commands must be followed by a carriage return) . 
CP/M should respond with another prompt (after several disk accesses) : 

A> 
If it does not, debug your disk write functions and retry. 

(12) Then test the directory command by typing 
DIR 

CP/M should respond with 
A: X COM 

(13) Test tne erase command by typing 
ERA X.COM 
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CP/M should respond with the A promot. When you make it this far^ you 
should have an operational system which will only require a bootstrap 
loader to function completely. 

(14) Write a bootstrap loader which is similar to GETSYS, and 
place it on track 0^ sector 1 using PUT3YS (again using the test 
diskette, not the distribution diskette) . See Sections 5 and 8 for 
more information on the bootstrap operation. 

(15) Retest the new test diskette with the bootstrap loader 
installed by executing steps (11), (12), and (13). Upon completion of 
these tests, type a control-C (control and C keys simultaneously) . The 
system should then execute a "warm start" which reboots the system, 
and types the A prompt. 

(16) At this point, you probably have a good version of your 
customized CP/M system on your test diskette. Use GETSYS to load CP/M 
from your test diskette. Remove the test diskette, place the 
distribution diskette (or a legal copy) into the drive, and use PUTSYS 
to replace the distribution version by your customized version. Do 
not make this replacement if you are unsure of your patch since this 
step destroys the system which was sent to you from Digital Research. 

(17) Load your modified CP/M system and test it by typing 

DIR 

CP/M should respond with a list of files which are provided on the 
initialized diskette. One such file should be the memory image for 
the debugger, called DDT.COM. 

NOTE: from now on, it is important that you always reboot tne CP/M 
system (ctl-C is sufficient) when the diskette is removed and replaced 
by anotner diskette, unless the new diskette is to be read only. 

(IB) Load and test the debugger by typing 

DDT 

(see the document "CP/M Dynamic Debugging Tool (DDT)" for operating 
procedures. You should take the time to become familiar with DDT, it 
will be your oest friend in later steps. 

(19) 3efore making further CBIOS modifications, practice using 
the editor (see the ED user's guide), and assembler (see the ASM 
user's guide). Then recede and test the GETSYS, PUTSYS, and CBIOS 
programs using ED, ASM, and DDT. Code and test a COPY program which 
does a sector-to-sector copy from one diskette to another to obtain 
back-up copies of the original diskette (NOTE: read your CP/M 
Licensing Agreement; it specifies your legal responsibilities when 
copying the CP/M system) . Place the copyright notice 

Copyright (c) , 1979 
Digital Research 
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on each copy which is made with yo^^^ COPy program. 

(20) Modify your CBIOS to include the extra functions for 
punches, readers, signon messages, and so-forth, and add the 
facilities for a aoditional disk drives, if desired. You can make 
these changes with the GETSYS and PUTSYS programs which you have 
developed, or you can refer to the following section, which outlines 
CP/M facilities which will aid you in the regeneration process. 

You now have a good copy of the customized CP/M system. Note that 
although the CBIOS portion of CP/M which you have developed belongs to 
you, the modified version of CP/M which you have created can be copied 
for your use only (again, read your Licensing Agreement) , and cannot 
be legally copied for anyone else's use. 

It should be noted that your system remains file-compatible with all 
other CP/M systems, (assuming media compatiblity , of course) which 
allows transfer of non-proprietary software between users of CP/M. 



^^ffl 
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3. SECOND LEVEL SYSTEM GENERATION 

Now that you have the CP/M system running, you will want to 
configure CP/M for your memory size. In general, you will first get a 
memory image of CP/M with the "MOVCPM" program (system relocator) and 
place this memory image into a named disk file. The disk file can then 
be loaded, examined, patched, and replaced using the debugger, and 
system generation program. For further details on the operation of 
these programs, see the "Guide to CP/M Features and Facilities" 
manual. 

Your CBIOS and BOOT can be modified using ED, and assembled using 
ASM, producing files called CBIOS. HEX and BOOT. HEX, which contain the 
machine code for CBIOS and BOOT in Intel hex format. 

To get the memory image of CP/M into the TPA configured for the 
desired memory size, give the command: 

MOVCPM XX * 

where "xx" is the memory size in decimal K bytes (e.g., 32 for 32K) . 
The response will oe: 

CONSTRUCTING xxK CP/M VERS 2.0 
READY FOR "SYSGEN" OR 
"SAVE 34 CPMxx.COM" 

At this Doint, an image of a CP/M in the TPA configured for the 
requested memory size. The memory image is at location d9Q\dH through 
227FH. (i.e.. The BOOT is at 0900H, the CCP is at 980H, the 3D0S 
starts at 1180H, and the BIOS is at 1F80H.) Note that the memory 
image has the standard MDS-800 BIOS and BOOT on it. It is now 
necessary to save the memory image in a file so that you can patch 
your CBIOS and CBOOT into it: 

SAVE 3 4 CPMxx.COM 

The memory image created by the "MOVCPM" program is offset by a 
negative bias so that it loads into the free area of the TPA, and thus 
does not interfere with the operation of CP/M in higher memory. This 
memory image can oe subsequently loaded under DDT and examined or 
changed in preparation for a new generation of the system. DDT is 
loaded with the memory image by typing: 

DDT CPMxx.COM Load DDT, then read the CP[ 

image 

DDT should respond with 

NEXT PC 
2300 0100 

(The DDT prompt) 

You can then use the display and disassembly commands to examine 
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portions of the memory image between 900H and 227FH. Note, however, 
that to find any particular address within the memory image, you must 
^Pply the negative bias to the CP/M address to find the actual 
address. Track 00, sector 01 is loaded to location 900H (you should 
find the cold start loader at 900H to 97FH) , track 00, sector 02 is 
loaded into 980H (this is the base of the CCP) , and so-forth through 
the entire CP/M system load. In a 20K system, for example, the CCP 
resides at the CP/M address 3400H, but is placed into memory at 980H 
by the SYSGEN program. Thus, the negative bias, denoted by n, 
satisfies 

3400H + n = 980H, or n = 980H - 3400H 

Assuming two's comolement arithmetic, n = D580H, which can be checked 
by 

3400H + D580H = 10980H = 0980H (ignoring nigh-order 

overflow) . 

Note that for larger systems, n satisfies 

(3400H+b) + n = 980H, or 
n = 980H - (3400H + b) , or 
n = D5 8 0H - b. 

The value of n for common CP/M systems is given below 

memory size bias b negative offset n 

20K 0000H D580H - 0000H = D580H 

24K 1000H D580H - 1000H = C580H 

32K 3000H D580H - 3000H = A580H 

40K 5000H D580H - 5000H = 8580H 

48K 7000H D580H - 7000H = 6580H 

56K 9000H D580H - 9000H = 4580H 

62K A800H D580H - A800H = 2D80H 

64K B000H D580H - 3000H = 2580H 

Assume, for example, that you want to locate the address x within the 
memory image loaded under DDT in a 20K system. First type 

Hx,n Hexadecimal sum and difference 

and DDT will respond with the value of x+n (sum) and x-n (difference) . 
The first number printed by DDT will be the actual memory address in 
the image where the data or code will be found. The input 

H3400,D580 

for example, will produce 980H as the sum, which is where the CCP is 
located in the memory image under DDT. 

Use tne L command to disassemble portions the BIOS located at 
(4A00H+D)-n which, when you use the H command, oroduces an actual 
address of 1F80H. The disassembly command would thus be 
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L1F80 

It is now necessary to oatch in your CBOOT and CBIOS routines. The 
BOOT resides at location 0900H in the memory image. If the actual 
load address is "n", then to calculate the bias (m) use the command: 

H900,n Subtract load address from 

target address. 

The second number typed in response to the command is the desired bias 
(m) . For example, if your BOOT executes at 0080H, tne command: 

H900,80 

will reply 

0980 0880 Sum and difference in hex. 

Therefore, the bias "m" would be 0880H. To read-in the BOOT, give the 
command: 



IC300T.HEX Input file CBOOT. HEX 



Then: 



Rm Read CBOOT with a bias of 

m (=900H-n) 

iTou may now examine your CBOOT with: 

L900 

We are now ready to replace tne CBIOS. Examine the area at 1F80H 
where the original version of the CBIOS resides. Then type 

ICBIOS.HEX Ready the "hex" file for loading 

assume that your CBIOS is being integrated into a 20K CP/M system, and 
thus is origined at location 4A00a. In order to properly locate the 
CBIOS in the memory image under DDT, we must apply the negative bias n 
for a 20K system when loading the hex file. This is accomplished oy 
typing 

RD580 Read the file with bias D580H 

Upon completion of the read, re-examine the area where the CBIQS has 
been loaded (use an "L1F80" command) , to ensure that is was loaded 
properly. When you are satisfied that the change has been made, 
return from DDT using a control-C or •"'G0" command. 

Now use SYSGEN to replace the patched memory image back onto a 
diskette (use a test cJiskette until you are sure of your patch) , as 
shown in the following interaction 
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SYSGEN 

SYSGEN VERSION 2.0 

SOURCE DRIVE NAME 



Start the SYSGEN program 
Sign-on message from SlxfSGEN 
(OR RETURN TO SKIP) 

Respond with a carriage return 
to skip the CP/M read operation 
since the system is already in 
memory. 

DESTINATION DRIVE NAME (OR RETURN TO REBOOT) 

Respond with "3" to write the 
new system to the diskette in 
drive B. 

DESTINATION ON B, THEN TYPE RETURN 

Place a scratch diskette in 
drive B, then type return. 



FUNCTION COMPLETE 
DESTINATION DRIVE 



NAME (OR RETURN TO REBOOT) 



Place the scratch diskette in your drive A, and then perform a 
:oldstart to bring up the new CP/M system you have configured. 

Test the new CP/M system, and place the Digital Research copyright 
lotice on the diskette, as specified in your Licensing Agreement: 

Copyright (c) , 1979 
Digital Research 
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4. SAMPLE GETSYS AND PUTSY3 PROGRAMS 

The following program provides a framework for the GETSYS and 
PUTSYS programs referenced in Section 2. The READSEC and V'JRITESEC 
subroutines must be inserted by the user to read and write the 
specific sectors. 

GETSYS PROGRAM - READ TRACKS AND 1 TO MEMORY AT 3380H 

USE 
(SCRATCH REGISTER) 
TRACK COUNT (0, 1) 
SECTOR COUNT (1,2,.. .,26) 
(SCRATCH REGISTER PAIR) 
LOAD ADDRESS 
SET TO STACK ADDRESS 

SET STACK POINTER TO SCRATCH AREA 

SET BASE LOAD ADDRESS 

START WITH TRACK 

READ NEXT TRACK (INITIALLY 0) 

READ STARTING WITH SECTOR 1 

READ NEXT SECTOR 

USER-SUPPLIED SUBROUTINE 

MOVE LOAD ADDRESS TO NEXT 1/2 PAGE 

HL = HL + 128 

SECTOR = SECTOR + 1 

CHECK FOR END OF TRACK 

CARRY GENERATED IF SECTOR < 27 

ARRIVE HERE AT END OF TRACK, MOVE TO NEXT TRACK 
INR B 

MOV A,B ;TEST FOR LAST TRACK 

CPI 2 
JC RDTRK ; CARRY GENERATED IF TRACK < 2 

ARRIVE HERE AT END OF LOAD, HALT FOR NOW 
HLT 

USER-SUPPLIED SUBROUTINE TO READ THE DISK 
READSEC: 

ENTER WITH TRACK NUMBER IN REGISTER B, 
SECTOR NUMBER IN REGISTER C, AND 
ADDRESS TO FILL IN HL 



; GE 


rSYS PI 


ROGRAM - 


REGISTER 






A 






B 






C 






DE 






HL 






SP 




START: 


LXI 


SP,3380H 




LXI 


H, 3380H 




MVI 


B, 


RDTRK: 








MVI 


c,i 


RDSEC: 








CALL 


READSEC 




LXI 


D,128 




DAD 


D 




If^R 


C 




MOV 


A,C 




CPI 


27 




JC 


RDSEC 



PUSH 
PUSH 



B 
H 



;SAVE B AND C REGISTERS 
;SAVE HL REGISTERS 



perform disk read at this point, branch to 
label START if an error occurs 



POP 


H 


POP 


B 


RET 





? RECOVER HL 

; RECOVER B AND C REGISTERS 

;BACK TO MAIN PROGRAM 

END START 
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Note that this program is assembled and listed in Appendix C for 
reference purposes, with an assumed origin of 1Q0H. The hexadecimal 
operation codes which are listed on the left may be useful if the 
program has to be entered through your machine's front panel switcnes. 

The PUTSYS program can be constructed from GETSYS by changing only 
a few operations in the GETSYS program given above, as shown in 
Appendix D. The register pair HL become the dump address (next 
address to write), and operations upon these registers do not change 
within the program. The READSEC subroutine is replaced by a WRITESEC 
subroutine which performs the opposite function: data from address HL 
is written to the track given by register B and sector given Dy 
register C, It is often useful to combine GETSYS and PUTSYS into a 
single program during the test and development phase, as shown in the 
Appendix . 



^H| 



(All Information Contained Herein is Proprietary to Digital Research.) 

11 



5. DISKETTE ORGANIZATION 

The sector allocation for the standard distribution version of 
CP/M is given here for reference purposes. The first sector (see 
table on the following page) contains an optional software boot 
section. Disk controllers are often set up to bring track id , sector 1 
into memory at a specific location (often location 0000H) . The 
program in this sector, called BOOT, has the responsibility of 
bringing the remaining sectors into m.emory starting at location 
3400H+b. If your controller does not have a built-in sector load, you 
can ignore the program in track 0, sector 1, and begin the load from 
track sector 2 to location 3400H+b. 

As an example, the Intel MDS-800 hardware cold start loader brings 
track 0, sector 1 into absolute address 3000H. Upon loading this 
sector, control transfers to location 3000H, where the bootstrap 
operation commences by loading the remainder of tracks 0, and all of 
track 1 into memory, starting at 3400H+b. The user should note that 
this bootstrap loader is of little use in a non-MDS environment, 
althougn it is useful to examine it since some of the boot actions 
will have to be duplicated in your cold start loader. 
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Track# Sector# 
00 01 



Page* 



Memory Address 
(boot address) 



CP/M Module name 
Cold Start Loader 



00 


02 


00 


3400H+b 


CCP 




■1 


03 


II 


3480H+b 


II 




II 


04 


01 


3500H+b 


<i 




li 


05 


II 


35B0H+b 


II 




II 


06 


02 


3600H+b 


II 




II 


07 


II 


3680H+b 


II 




II 


08 


03 


3700H+D 


II 




•1 


09 


II 


3780H+b 


II 




II 


10 


04 


3800H+b 


• 1 




II 


11 


II 


3880H+b 


II 




II 


12 


05 


3900H+b 


• 1 




II 


13 


II 


3980H+b 


II 




II 


14 


06 


3A00H+b 


II 




•• 


15 


II 


3A80H+b 


'• 




II 


16 


07 


3B00H+b 


II 




00 


17 


II 


3B80H+b 


CCP 







18 


08 


3C00H+b 


BDOS 




II 


19 


• 1 


3C80H+b 


II 




II 


20 


09 


3D00H+b 


II 




II 


21 


II 


3D80H+b 


II 




• 1 


22 


10 


3E00H+b 


II 




II 


23 


II 


3E30H+b 


•1 




II 


24 


11 


3F00H+b 


II 




II 


25 


II 


3F80H+b 


II 




II 


26 


12 


4000H+b 


II 




01 


01 


II 


4080H+b 


II 




•1 


02 


13 


4l00H+b 


II 




II 


03 


II 


4180H+b 


II 




II 


04 


14 


4200H+b 


II 




il 


05 


'• 


4280H+b 


•1 




II 


06 


15 


4300H+b 


" 




II 


07 


II 


4380H+b 


II 




■I 


08 


16 


4400H+b 


• 1 




II 


09 


■ 1 


4480H+b 


II 




li 


10 


17 


4500H+b 


II 




II 


11 


II 


4580H+b 


II 




II 


12 


18 


4600H+b 


II 




II 


13 


II 


4680H+b 


II 




II 


14 


19 


4700H+b 


II 




•• 


15 


•1 


4780H+b 


II 




II 


16 


20 


4800H+b 


II 




II 


17 


II 


4880H+b 


II 




II 


18 


21 


4900H+b 


II 




01 


19 


II 


4980H+b 


BDOS 




01 


20 


22 


4A00H+b 


BIOS 




II 


21 


It 


4A80H+b 


II 




II 


23 


23 


4B00H+b 


II 




II 


24 


II 


4B80H+b 


II 




II 


25 


24 


4C00H+b 


kl 




01 


26 


i< 


4C80H+b 


BIOS 




02-76 


01-26 






(directory and 


data) 
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6. THE BIOS ENTRY POINTS 



into the BIOS from the cold start loader and BDOS 
Entry to the BIOS is through a "jump vector" 
as shown below (see Appendices B and C, as well) . 
sequence of 17 jump instructions which send 
the individual BIOS subroutines. The BIOS 
subroutines may be empty for certain functions (i.e., they may contain 
a single RET operation) during regeneration of CP/Mr but the entries 
must be present in the jump vector. 



The entry points 
are detailed below, 
located at 4A00H-fb, 
The jump vector is a 
program control to 



The jump vector at 4A00H+b takes the form shown below, 
individual jump addresses are given to the left: 



where the 



4A00H+b 


J MP 


BOOT 


4A03d+D 


J MP 


WBOOT 


4A06H+b 


J MP 


CONST 


4A09H+b 


J MP 


CONIN 


4A0CH+b 


J MP 


CONOUT 


4A0FH+b 


J MP 


LIST 


4Al2H+b 


J MP 


PUNCH 


4Al5H+b 


J MP 


READER 


4Al8H+b 


J MP 


HOME 


4AlBii+b 


J MP 


SELDSK 


4A1EH+D 


J MP 


SETTRK 


4A21H+D 


J MP 


SETS EC 


4A2 4H+D 


J MP 


SETDMA 


4A27H+b 


J MP 


READ 


4A2Ari+b 


J MP 


WRITE 


4A2DH+b 


J MP 


LISTST 


4A3 0H+b 


J MP 


SECT RAN 



ARRIVE HERE FROM COLD START LOAD 

ARRIVE HERE FOR V7ARM START 

CHECK FOR CONSOLE CHAR READY 

READ CONSOLE CHARACTER IN 

WRITE CONSOLE CHARACTER OUT 

WRITE LISTING CHARACTER OUT 

WRITE CHARACTER TO PUNCH DEVICE 

READ READER DEVICE 

MOVE TO TRACK 00 ON SELECTED DISK 

SELECT DISK DRIVE 

SET TRACK NUMBER 

SET SECTOR NUMBER 

SET DMA ADDRESS 

READ SELECTED SECTOR 

WRITE SELECTED SECTOR 

RETURN LIST STATUS 

SECTOR TRANSLATE SUBROUTINE 



Each jumo address corresponds to a particular subroutine which 
performs the specific function, as outlined below. There are three 
major divisions in the jump table: the system (re) initialization 
whicn results from calls on BOOT and WBOOT, simple character I/O 
performed by calls on CONST, CONIN, CONOUT, LIST, PUNCH, READER, and 
LISTST, and diskette I/O oerformed by calls on HOME, SELDSK, SETTRK, 
SETSEC, SETDMA, READ, WRITE, and SECTRAN. 

All simple character I/O operations are assumed to be performed in 
ASCII, upper and lower case, with high order (parity bit) set to zero. 
An end-of-file condition for an input device is given by an ASCII 
control-z (lAH) . Peripheral devices are seen by CP/M as "logical" 
devices, and are assigned to physical devices within the BIOS. 

In order to operate, the BDOS needs only the CONST, CONIN, and 
CONOUT subroutines (LIST, PUNCH, and READER may be used by PIP, but 
not the BDOS). Further, the LISTST entry is used currently only by 
DESPOOL, and thus, the initial version of CBIOS may have empty 
subroutines for the remaining ASCII devices. 
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The characteristics of each device are 

CONSOLE The principal interactive console which communicates 
with the operator, accessed through CONST, CONIN, and 
CONOUT. Typically, the CONSOLE is a device such as a 
CRT or Teletype. 

LIST The principal listing device, if it exists on your 
system, which is usually a hard-copy device, such as a 
printer or Teletype. 

PUNCH The principal tape punching device, if it exists, which 
is normally a high-speed paper tape punch or Teletype. 

READER The principal tape reading device, such as a simple 
optical reader or Teletype. 



Note that a 
the LIST, PUNC 
no peripheral d 
READER device, 
an appropriate 
not "hang'* if t 
other user pr 
routines can ju 
can return with 
immediate end-o 



single per 
H, and READ 
evice is as 
the CBIOS c 
error me 
he device i 
ogram. Al 
St simply r 

a IAh" (ctl 
f-f ile. 



ipheral can be assigned as 
ER device simultaneously. If 
signed as the LIST, PUNCH, or 
reated by the user may give 
ssage so that the system does 
s accessed by PIP or some 
ternately, the PUNCH and LIST 
eturn, and the READER routine 
-Z) in reg A to indicate 



For adde 
implement t 
reassignment 
lOBYTE fun 
physical dev 
processing 
the lOBYTE f 
as follows: 
location 000 
defines the 
in effect 
performed by 
fields of 
PUNCH, and L 



d flexibility, 
he "lOBYTE" 

of physical 
ction creates 
ices which can 
(see the STAT c 
unction correspo 
a single io 
3H) is maintain 
logical to physi 
at a particula 
splitting the I 
two bits each, 
1ST fields, as s 



most significant 
lOBYTE AT 0003H I LIST I PUNCH 



the user can optionally 
function wnich allows 
and logical devices. The 
a mapping of logical to 
be altered during CP/M 
ommand) . The definition of 
nds to the Intel standard 
cation in memory (currently 
ea, called lOBYTE, which 
cal device mapping which is 
r time. The mapping is 
OBYTE into four distinct 
called the CONSOLE, READER, 
hown below: 

least significant 

READER I CONSOLE I 



bits 6,7 bits 4,5 bits 2,3 bits 0,1 

The value in each field can be in the range 0-3, 
defining the assigned source or destination of each 
logical device. The values which can be assigned to 
each field are given below 
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CONSOLE field (bits 0,1) 

- console is assigned to tne console printer device (TTY:) 

1 - console is assigned to the CRT device (CRT:) 

2 - batch mode: use the READER as the CONSOLE input, 

and the LIST device as the CONSOLE output (BAT:) 

3 - user defined console device (UCl:) 

READER field (bits 2,3) 

- READER is the Teletype device (TTY:) 

1 - READER is the high-speed reader device (RDR:) 

2 - user defined reader # 1 (URl:) 

3 - user defined reader # 2 (UR2:) 

PUNCH field (bits 4,5) 

- PUNCH is the Teletype device (TTY:) 

1 - PUNCH is the high speed punch device (PUN:) 

2 - user defined punch # 1 (UPl:) 

3 - user defined punch # 2 (UP2:) 

LIST field (bits 6,7) 

- LIST is the Teletype device (TTY:) 

1 - LIST is the CRT device (CRT:) 

2 - LIST is the line printer device (LPT:) 

3 - user defined list device (ULl:) 

Note again that the implementation of the lOBYTE is 
optional, and affects only the organization of your 
CBIOS. No CP/M systems use the lOBYTE (although they 
tolerate the existence of the lOBYTE at location 
0e)03H) , except for PIP which allows access to the 
physical devices, and STAT which allows 
logical-physical assignments to be made and/or 
displayed (for more information, see the "CP/M Features 
and Facilities Guide"). In any case, the lOBYTE 
implementation should be omitted until your basic CBIOS 
is fully implemented and tested; then add the lOBYTE to 
increase your facilities. 

Disk I/O is always performed through a sequence of 
calls on the various disk access subroutines which set 
up the disk number to access, the track and sector on a 
particular disk, and the direct memory access (DMA) 
address involved in the I/O operation. After all these 
parameters have been set up, a call is made to the READ 
or WRITE function to perform the actual I/O operation. 
Note that there is often a single call to SELDSK to 
select a disk drive, followed by a number of read or 
write operations to the selected disk before selecting 
another drive for subsequent operations. Similarly, 
there may be a single call to set the DMA address, 
followed by several calls which read or write from the 
selected DMA address pefore the DMA address is changed. 
The track and sector suDroutines are always called 
before tne READ or WRITE operations are performed. 
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The exact responsibili tes of each entry point 
subroutine are given below: 

The BOOT entry point gets control from the cold start 
loader and is responsible for basic system 
initialization, including sending a signon message 
(which can be omitted in the first version) . If the 
lOBYTE function is implemented, it must be set at this 
point. The various system parameters which are set by 
the WBOOT entry point must be initialized, and control 
is transferred to the CCP at 3400H+b for further 
processing. Note that reg C must be set to zero to 
select drive A. 

The WBOOT entry point gets control when a warm start 
occurs. A warm start is performed whenever a user 
program branches to location 0000K, or when the CPU is 
reset from the front panel. The CP/M system must be 
loaded from the first two tracks of drive A up to, but 
not including, the BIOS (or CBIOS, if you have 
completed your patch) . System parameters must be ini- 
tialized as shown below: 



CONST 



location 
location 



.1.2 



location 5,6,7 



set to JMP WBOOT for warm starts 
(0000H: JMP 4A03H+b) 

set initial value of lOBYTE, if 
implemented in your CBIOS 

set to JMP BDOS, which is the 
primary entry point to CP/M for 
transient programs. (0005H: JMP 
3C06H+b) 



CONIN 



(see Section 9 for complete details of page zero use) 
Upon completion of the initialization, the WBOOT 
program must branch to the CCP at 3400H+b to (re) start 
the system. Upon entry to the CCP, register C is set 
to the drive to select after system initialization. 

Sample the status of the currently assigned console 

device and return 0FFH in register A if a character is 

ready to read, and 00H in register A if no console 

characters are ready. 

Read the next console character into register A, and 



(All Information Contained Herein is Proprietary to Digital Research.) 

17 



CONOUT 



LIST 



PUNCH 



READER 



HOME 



SELDSK 



set the parity oit (high order bit) to zero. If no 
console character is ready, wait until a character is 
typed Detore returning. 



Send the character from regis 
output device. The characte 
order parity bit set to zero. 
a time-out on a line feed or c 
console device requires some 
of the line (such as a TI Sile 
can, if you wish, filter out 
cause your console device to r 
control-z causes the Lear Seig 
the screen, for example) . 



ter C to the console 
r is in ASCII, with high 
You may want to include 
arriage return, if your 
time interval at the end 
nt 700 terminal) . You 
control characters which 
eact in a strange way (a 
ler terminal to clear 



Send the character from register C to the currently 
assigned listing device. The character is in ASCII 
with zero parity. 

Send the character from register C to the currently 
assigned punch device. The character is in ASCII with 
zero parity. 

Read the next character from the currently assigned 
reader device into register A with zero parity (high 
order bit must be zero) , an end of file condition is 
reported by returning an ASCII control-z (lAH) , 

Return the disk head of the currently selected disk 
(initially disk A) to the track 00 position. If your 
controller allows access to the track flag from the 
drive, step the head until the track flag is 
detected. If your controller does not support this 
feature, you can translate the HOME call into a call 
on SETTRK with a parameter of 0. 

Select the disk drive given by register C for further 
operations, wnere register C contains for drive A, 1 
for drive B, and so-forth up to 15 for drive P (the 
standard CP/M distribution version supports four 
drives) . On each disk select, SELDSK must return in 
HL the base address of a 16-byte area, called the Disk 
Parameter Header, described in the Section 10. For 
standard floppy disk drives, the contents of the 
header and associated tables does not change, and thus 
the program segment included in the sample CBIOS 
performs this operation automatically. If there is an 
attempt to select a non-existent drive, SELDSK returns 
HL=0000H as an error indicator. Although SELDSK must 
return the header address on each call, it is 
advisable to postpone the actual physical disk select 
operation until an I/O function (seek, read or write) 
is actually performed, since disk selects often occur 
without utimately performing any disk I/O, and many 
controllers will unload the head of the current disk 
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Register BC contains the track number for subsequent 
disk accesses on the currently selected drive. !xfou 
can choose to seek the selected track at this time, or 
delay the seek until the next read or write actually 
occurs. Register BC can take on values in the range 
0-76 corresponding to valid track numoers for standard 
floppy disk drives, and 0-65535 for non-standard disk 
subsystems. 

Register BC contains the sector number (1 through 26) 
for subsequent disk accesses on the currently selected 
drive. Zou can choose to send this information to the 
controller at this point, or instead delay sector 
selection until a read or write ooeration occurs. 
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READ 



Assuming the drive has been selected, the track has 
been set, the sector has been set, and the DMA address 
has been specified, the READ subroutine attempts to 
read one sector based upon these parameters, and 
returns the following error codes in register A: 




1 



no errors occurred 

non-recoverable error condition occurred 



vVRITE 



Currently, CP/M responds only to a zero or non-zero 
value as tne return code. That is, if the value in 
register A is then CP/M assumes that the disk 
operation completed properly. If an error occurs, 
however, the CBIOS should attempt at least 10 retries 
to see if the error is recoverable. When an error is 
reported the BDOS will print the message "BDOS ERR ON 
x: BAD SECTOR". The operator then has the option of 
typing <cr> to ignore the error, or ctl-C to abort. 

Write the data from the currently selected DMA address 
to the currently selected drive, track, and sector. 
The data should be marked as "non deleted data" to 
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maintain compatibility with other CP/M systems. The 
error codes given in the READ command are returned in 
register A, with error recovery attempts as described 
above. 

LISTST Return the ready status of the list device. Used by 
the DESPOOL program to improve console response during 
its operation. The value 00 is returned in A if the 
list device is not ready to accept a character^ and 
0FFH if a character can be sent to the printer. Note 
that a 00 value always suffices. 

SECTRAN Performs sector logical to physical sector translation 
in order to improve the overall response of CP/M. 
Standard CP/M systems are shipped with a "skew factor" 
of 6 r where six physical sectors are skipped between 
each logical read operation. This skew factor allows 
enough time between sectors for most programs to load 
their buffers without missing the next sector. In 
particular computer systems which use fast processors, 
memory, and disk subsystems, the skew factor m.ay be 
changed to improve overall response. Note, however, 
that you should maintain a single density IBM 
compatible version of CP/M for information transfer 
into and out of your computer system, using a skew 
factor of 6. In general, SECTRAN receives a logical 
sector number in BC, and a translate table address in 
DE. The sector number is used as an index into the 
translate table, with the resulting physical sector 
number in BL. For standard systems, the tables and 
indexing code is orovided in the CBIOS and need not be 
changed. 
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1 . A SAMPLE BIOS 

The program shown in Appendix C can serve as a basis for your 
first BIOS. The simplest functions are assumed in this BlOSr so that 
you can enter it through the front panels if absolutely necessary. 
iMote that the user must alter and insert code into the subroutines for 
COiSIST, CONIN, CONOUT, READ, WRITE, and WAITIO subroutines. Storage is 
reserved for user-supplied code in these regions. The scratch area 
reserved in page zero (see Section 9) for the BIOS is used in this 
program, so that it could be implemented in ROM, if desired. 

Once operational, this skeletal version can be enhanced to print 
the initial sign-on message and perform better error recovery. The 
subroutines for LIST, PUNCH, and READER can be filled-out, and the 
lOBYTE function can be implemented. 



^Rffl 
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8. A SAMPLE COLD START LOADER 

The program shown in Appendix D can serve as a basis for your cold 
start loader. The disk read function must De supplied by the user, 
and the program must be loaded somehow starting at location 0000. 
LMote tnat space is reserved for your patch so that the total amount of 
storage required for the cold start loader is 128 bytes. Eventually, 
you v/ill probably want to get this loader onto the first disk sector 
(track 0, sector 1), and cause your controller to load it into memory 
automatically upon system start-up. Alternatively, you may wish to 
place tne cold start loader into ROM, and place it above the CP/M 
system. In this case, it will be necessary to originate the program 
at a higher address, and key-in a jump instruction at system start-up 
whicn brancnes to the loader. Subsequent warm starts will not require 
this key-in operation, since the entry point *WBOOT' gets control, 
thus bringing the system in from disk automatically. Note also that 
the skeletal cold start loader has minimal error recovery, which may 
be enhanced on later versions. 
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9. RESERVED LOCATIONS IN PAGE ZERO 

Main memory page zero, between locations 00H and 0FFH, contains 
several segments of code and data which are used during CP/i4 
processing. The code and data areas are given below for reference 
purposes. 

Locations Contents 

from to 

0000H - 0002H Contains a jump instruction to the warm start 

entry point at location 4A03H+b. This allows a 
simple programmed restart (JHP 0000H) or manual 
restart from the front oanel. 

0003H - 0003H Contains the Intel standard lOBYTE, which is 

optionally included in the user's CBIOS, as 
described in Section 6. 

0004H - 0004H Current default drive number (0=A, . . . ,15=P) . 

0005H - 0007H Contains a jump instruction to the BDOS.and 

serves two purposes: JMP 0005H provides the 
primary entry point to the BOOS, as described in 
the manual "CP/M Interface Guide," and LHLD 
0006H brings the address field of the 
instruction to the HL register pair. This value 
is the lowest address in memory used by CP/M 
(assuming the CCP is being overlayed) . Note 
that the DDT program will change the address 
field to reflect the reduced memory size in 
debug mode. 

0008H - 0027H (interrupt locations 1 through 5 not used) 

0030H - 0037H (interrupt location 6, not currently used 

reserved) 

0038H - 003AH Restart 7 - Contains a jump instruction into tne 

DDT or SID program when running in debug mode 
for programmed breakpoints, but is not otherwise 
used by CP/M. 

003BH - 003FH (not currently used - reserved) 

0040H - 004FH 16 byte area reserved for scratch by CBIOS, but 

is not used for any purpose in the distribution 
version of CP/M 

0050H - 005BH (not currently used - reserved) 

005CH - 007CH default file control block produced for a 

transient program by the Console Command 
Processor. 

007DH - 007FH Optional default random record position 
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^n| 



0080x4 - 00FFH default 128 byte disk buffer (also filled with 

the command line when a transient is loaded 
under the CCP) . 



Note that this information is set-up for normal operation under 
the CP/M system, but can be overwritten by a transient program if the 
BDOS facilities are not required by the transient. 

If, for example, a particular program performs only simple I/O and 
must begin execution at location 0, it can be first loaded into the 
TPA, using normal CP/M facilities, with a small memory move program 
which gets control wnen loaded (the memory move program must get 
control from location 0100H, which is the assumed beginning of all 
transient programs) . The move program can then proceed to move the 
entire memory image down to location 0, and pass control to the 
starting address of the memory load. Wote that if the BIOS is 
overwritten, or if location (containing the warm start entry point) 
is overwritten, then the programmer must bring the CP/M system back 
into memory v/ith a cold start sequence. 
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10. DISK PARAMETER TABLES. 

Tables are included in the BIOS which describe the particular 
characteristics of the disk subsystem used with CP/M. These tables 
can be either hand-coded, as shown in the sample CBIOS in Appendix C, 
or automatically generated using the DISKDEF macro library, as shown 
in Appendix B. The purpose here is to describe the elements of these 
tables. 

In general, each disk drive has an associated (16-byte) disk 
parameter header which both contains information about the disk drive 
and provides a scratchpad area for certain BDOS operations. The 
format of the disk parameter header for each drive is shown below 

Disk Parameter Header 

I XLT I 0000 I 0000 I 0000 IDIRBUFI DPB I CSV I ALV I 

16b 16b 16b 16b 16b 16b 16b 16b 

where each element is a word (16-bit) value. The meaning of each Disk 
Parameter Header (DPH) element is 

XLT Address of the logical to physical translation vector, 
if used for this particular drive, or the value 0000H 
if no sector translation takes place (i.e, the physical 
and logical sector numbers are the same). Disk drives 
with identical sector skew factors share the same 
translate tables. 

0000 Scratchpad values for use within the BDOS (initial 
value is unimportant) . 

DIRBUF Address of a 128 byte scratchpad area for directory 
operations within BDOS. Ail DPH * s address the same 
scratchpad area. 

DPB Address of a disk parameter block for this drive. 
Drives with identical disk characteristics address the 
same disk parameter block. 

CSV Address of a scratchpad area used for software check 
for changed disks. This address is different for each 
DPH. 

ALV Address of a scratchpad area used by the BDOS to keep 
disk storage allocation information. This address is 
different for each DPH. 

Given n disk drives, the DPH ' s are arranged in a table whose first row 
of 16 bytes corresponds to drive 0, with the last row corresponding to 
drive n-1 . The table thus appears as 
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DEBASE: 

00 IXLT 001 0000 I 0000 I 0000 iDIRBUFlDBP 00|CSV 00|ALV 00| 

01 IXLT 011 0000 I 0000 I 0000 IDIRBUFlDBP 01|CSV 01|ALV 01| 

(and so-forth through) 
n-llXLTn-ll 0000 I 0000 I 0000 |DIRBUF|DBPn-l ICSVn-1 |ALVn-l| 

where the label DPBASE defines the base address of the DPH table. 

A responsibility of the SELDSK subroutine is to return the base 
address of the DPH for the selected drive. The following sequence of 
operations returns the table address, with a 0000H returned if the 
selected drive does not exist. 

NDISKS EQU 4 jNUMBER OF DISK DRIVES 

SELDSK: 

; SELECT DISK GIVEN BY BC 
LXI H,0000H ; ERROR CODE 
MOV A,C ; DRIVE OK? 
CPI NDISKS ;CY IF SO 
RNC ;RET IF ERROR 

;N0 ERROR, CONTINUE 



MOV 


L,C i 


! LOW (DISK) 


MOV 


H,B ; 


fHIGH(DISK) 


DAD 


H ; 


•,*2 


DAD 


H ; 


.*4 


DAD 


H 


',*8 


DAD 


H ; 


r*16 


LXI 


D, DPBASE ; 


; FIRST DPH 


DAD 


D i 


;DPH{DISK) 


RET 







The translation vectors (XLT 00 through XLTn-1) are located 
elsewhere in the BIOS, and simply correspond one-for-one with the 
logical sector numbers zero through the sector count-1. The Disk 
Parameter Block (DPB) for each drive is more complex. A particular 
DPB/ which is addressed by one or more DPH's, takes the general form 

I SPT iBSHlBLMlEXMl DSM I DRM |AL0|AL1| CKS I OFF I 

16b 8b 8b 8b 16b 16b 8b 8b 16b 16b 

where each is a byte or word value, as shown by the "8b" or "16b" 
indicator below the field, 

SPT is the total number of sectors per track 

BSH is the data allocation block shift factor, determined 
by the data block allocation size. 
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EXM 

DSM 
DRM 

CKS 
OFF 



is the extent mask, determined by the data block 
allocation size and the number of disk blocks. 

determines the total storage capacity of the disk drive 

determines the total number of directory entries which 
can be stored on this drive AL0,AL1 determine reserved 
directory blocks, 

is the size of the directory check vector 

is the number of reserved tracks at the beginning of 
the (logical) disk. 



The values of BSH and BLM determine (implicitly) the data allocation 
size BLSr which is not an entry in the disk parameter block. Given 
that the designer has selected a value for BLS, the values of BSH and 
BLM are shown in the table below 



BLS 


BSH 


BLM 


1,024 


3 


7 


2,048 


4 


15 


4,096 


5 


31 


8,192 


6 


63 


6,384 


7 


127 



where all values are in decimal. The value of EXM depends upon both 
the BLS and whether the DSM value is less than 256 or greater than 
255, as shown in the following table 



BLS 


DSM 


< 


256 


DSM > 255 


1,024 









N/A 


2,048 




1 







4,096 




3 




1 


8,192 




7 




3 


6,384 




15 




7 



The value of DSM is the maximum data block number supported by 
this particular drive, measured in BLS units. The product BLS times 
(DSM+1) is the total number of bytes held by the drive and, of course, 
nust be within the capacity of the physical disk, not counting the 
reserved operating system tracks. 

The DRM entry is the one less than the total number of directory 
entries, which can take on a 16-bit value. The values of AL0 and ALl , 
lowever, are determined by DRM. The two values AL0 and ALl can 
together be considered a string of 16-bits, as shown below. 
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I AL0 I ALl I 

I I I I I I I i I I I i I I I I I 

00 01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 

where position 00 corresponds to the high order bit of the byte 
labelled AL0 ^ and 15 corresponds to the low order bit of the byte 
labelled ALl, Each bit position reserves a data block for number of 
directory entries, thus allowing a total of 16 data blocks to be 
assigned for directory entries (bits are assigned starting at 00 and 
filled to the right until position 15) . Each directory entry occupies 
32 byteSr resulting in the following table 

BLS Directory Entries 



1,024 


32 


times 


# 


bits 


2,048 


64 


times 


# 


bits 


4,096 


128 


times 


# 


bits 


8,192 


256 


times 


# 


bits 


6,384 


512 


times 


# 


bits 



Thus, if DRM = 127 (128 directory entries) , and BLS = 1024, then there 
are 32 directory entries per block, requiring 4 reserved blocks. In 
this case, the 4 hiqh order bits of AL0 are set, resulting in the 
values AL0 = 0F0H and ALl = 00H. 

The CKS value is determined as follows: if the disk drive media 
is removable, then CKS = (DRiyi+l)/4, where DRM is the last directory 
entry number. If the media is fixed, then set CKS = (no directory 
records are checked in this case) . 

Finally, the OFF field determines the number of tracks which are 
skipped at the beginning of the physical disk. This value is 
automatically added whenever SETTRK is called, and can be used as a 
mechanism for skipping reserved operating system tracks, or for 
partitioning a large disk into smaller segmented sections. 

To complete the discussion of the DPS, recall that several DPH ' s 
can address the same DPB if their drive characteristics are identical. 
Further, the DPB can be dynamically changed when a new drive is 
addressed by simply changing the pointer in the DPH since the BDOS 
copies the DPB values to a local area whenever the SELDSK function is 
invoked. 

Returning back to the DPH for a particular drive, note that the 
two address values CSV and ALV remain. Both addresses reference an 
area of uninitialized memory following the BIOS. The areas must be 
unique for each drive, and the size of each area is determined by the 
values in the DPB. 

The size of the area addressed by CSV is CKS bytes, which is 
sufficient to hold the directory check information for this particular 
drive. If CKS = (DRM4-l)/4, then you must reserve (DRM+l)/4 bytes for 
directory check use. If CKS = 0, then no storage is reserved. 
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The size of the area addressed by ALV is determined by the 
laximum number of data blocks allowed for this particular disk, and is 
:omputed as (DSM/8)4-l. 

The CBIOS shown in Appendix C demonstrates an instance of these 
'.ables for standard 8" single density drives. It may be useful to 
jxamine this program, and compare the tabular values with the 
lefinitions given above. 



Appendix 
G 
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11. THE DISKDEF MACRO LIBRARY. 

A macro library is shown in Appendix F, called DISKDEF, whicl: 
greatly simplifies the table construction process. You must have 
access to the MAC macro assembler, of course, to use the DISKDEI 
facility, while the macro library is included with all CP/M 2,ii 
distribution disks. 

A BIOS disk definition consists of the following sequence oJ 
macro statements: 



MACLIB 


DISK 


DEF 


• ••••• 

DISKS 


n 




DISKDEF 


0,.. 


• 


DISKDEF 


1,.. 


• 


DISKDEF 


n-1 





ENDEF 

where the MACLIB statement loads the DISKDEF. LIB file (on the same 
disk as your BIOS) into MAC's internal tables. The DISKS macro cai; 
follows, which specifies the number of drives to be configured wit) 
your system, where n is an integer in the range 1 to 16. A series o: 
DISKDEF macro calls then follow which define the characteristics o: 
each logical disk, through n-1 (corresponding to logical drives I 
through P) . Note that the DISKS and DISKDEF macros generate th< 
in-line fixed data tables described in the previous section, and thui 
must be placed in a non-executable portion of your BIOS, typically 
directly following the BIOS jump vector. 

The remaining portion of your BIOS is defined following th< 
DISKDEF macros, with the ENDEF macro call immediately preceding th' 
END statement. The ENDEF (End of Diskdef) macro generates th' 
necessary uninitialized RAM areas which are located in memory abov( 
your BIOS. 

The form of the DISKDEF macro call is 

DISKDEF dn,fsc,lsc, [skf] ,bls ,dks,dir ,cks, of s , [0] 

where 

dn is the logical disk number, to n-1 

fsc is the first physical sector number (0 or 1) 

Isc is the last sector number 

skf is the optional sector skew factor 

bis is the data allocation block size 

dir is the number of directory entries 

cks is the number of "checked" directory entries 

ofs is the track offset to logical track 00 

[0] is an optional 1.4 compatibility flag 

The value "dn" is the drive number being defined with this DISKDE 
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macro invocation, 
numbering systems^ 
numbered sector on 
the sector skew 
table according to 



The "fsc" parameter accounts for differing sector 
and is usually or 1. The "Isc" is the last 
a track. When present, the "skf" parameter defines 
factor which is used to create a sector translation 
«^v.vyi.^xiiy L-w the skew. If the number of sectors is less than 
256, a single-byte table is created, otherwise each translation table 
element occupies two bytes. No translation table is created if the 
skf parameter is omitted (or equal to 0) . The "bis" parameter 
specifies the number of bytes allocated to each data block, and takes 
on the values 1024, 2048, 4096, 8192, or 16384. Generally, 
performance increases with larger data block sizes since there are 
fewer directory references and logically connected data records are 
physically close on the disk. Further, each directory entry addresses 
more data and the BIOS-resident ram space is reduced. The "dks" 
specifies the total disk size in "bis" units. That is, if the bis 
2048 and dks = 1000, then the total disk capacity is 2,048,000 bytes. 
If dks is greater than 255, then the block size parameter bis must be 
greater than 1024. The value of "dir" is the total number of 
directory entries which may exceed 255, if desired. The "cks" 
parameter determines the number of directory items to check on each 
directory scan, and is used internally to detect changed disks 
system operation, where an intervening cold or warm start 
occurred (when this situation is detected, CP/M automatically 
the disk read/only so that data is not subsequently destroyed) 
stated in the previous section, the value of cks = dir when 
is easily changed, as is the case with a floppy disk subsystem, 
the disk is permanently mounted, then the value of cks is typically 
since the probability of changing disks without a restart 
low. The "ofs" value determines the number of tracks to skip when 
this particular drive is addressed, which can be used to reserve 
additional operating system space or to simulate several logical 
drives on a single large capacity physical drive. Finally, the [0] 
parameter is included when file compatibility is required with 
versions of 1.4 which have been modified for higher density disks. 
This parameter ensures that only 16K is allocated for each directory 
record, as was the case for previous versions. Normally, 
parameter is not included. 



during 
has not 
marks 
. As 
the media 
If 

is quite 



this 



For convenience and economy of table space, the special form 

DISKDEF i,j 

gives disk i the same characteristics as a previously defined drive j. 
A standard four-drive single density system, which is compatible with 
version 1.4, is defined using the following macro invocations: 
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DISKS 4 

DISKDEF 0,1,26,6,1024,243,64,64,2 

DISKDEP 1,0 

DISKDEF 2,0 

DISKDEF 3,0 

• • • • 

ENDEF 

with all disks having the same parameter values of 26 sectors per 
track (numbered 1 through 26), with 6 sectors skipped between each 
access, 1024 bytes per data block, 243 data blocks for a total of 243k 
byte disk capacity, 64 checked directory entries, and two operating 
system tracks. 

The DISKS macro generates n Disk Parameter Headers (DPH's), 
starting at the DPH table address DPBASE generated by the macro. Each 
disk header block contains sixteen bytes, as described above, and 
correspond one-for-one to each of the defined drives. In the four 
drive standard system, for example, the DISKS macro generates a table 
of the form: 

DPBASE EQU $ 

DPE0: DW XLT0,0000H,0000H,0000H,DIRBUF,DPB0,CSV0,ALV0 

DPEl: DW XLT0,0000H,0000H,0000H,DIRBUF,DPB0,CSV1,ALV1 

DPE2: DW XLT0 , 0000H , 0000H , 0000H ,DIRBUF ,DPB0 ,CSV2 , ALV2 

DPE3: DW XLT0 , 000H , 00 00H , 0000H ,DIRBUF ,DPB0 ,CSV3 ,ALV3 

where the DPH labels are included for reference purposes to show the 
beginning table addresses for each drive through 3. The values 
contained within the disk parameter header are described in detail in 
the previous section. The check and allocation vector addresses are 
generated by the ENDEF macro in the ram area following the BIOS code 
and tables. 

Note that if the "skf" (skew factor) parameter is omitted (or 
equal to 0) , the translation table is omitted, and a 0000H value is 
inserted in the XLT position of the disk parameter header for the 
disk. In a subsequent call to perform the logical to physical 
translation, SECTRAN receives a translation table address of DE 
0000H, and simply returns the original logical sector from BC in the 
HL register pair. A translate table is constructed when the skf 
parameter is present, and the (non-zero) table address is placed into 
the corresponding DPH's. The table shown below, for example, is 
constructed when the standard skew factor skf = 6 is specified in the 
DISKDEF macro call: 

XLT0: DB 1,7,13,19,25,5,11,17,23,3,9,15,21 
DB 2,8,14,20,26,6,12,18,24,4,10,16,22 

Following the ENDEF macro call, a number of uninitialized data 
areas are defined. These data areas need not be a part of the BIOS 
which is loaded upon cold start, but must be available between the 
BIOS and the end of memory. The size of the uninitialized RAM area is 
determined by EQU statements generated by the ENDEF macro. For a 
standard four-drive system, the ENDEF macro might produce 
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4C72 = BEGDAT EQU $ 
(data areas) 
4DB0 = ENDDAT EQU $ 
013C = DATSIZ EQU $-BEGDAT 

which indicates that uninitialized RAM begins at location 4C72H, ends 
at 4DB0H-1^ and occupies 013CH bytes. You must ensure that these 
addresses are free for use after the system is loaded. 

After modification, you can use the STAT program to check your 
drive characteristics, since STAT uses the disk parameter block to 
decode the drive information. The STAT command form 

STAT d:DSK: 

decodes the disk parameter block for drive d (d=A,...,P) and displays 
the values shown below: 

r: 128 Byte Record Capacity 

k: Kilobyte Drive Capacity 

d: 32 Byte Directory Entries 

c: Checked Directory Entries 

e: Records/ Extent 

b: Records/ Block 

s: Sectors/ Track 

t: Reserved Tracks 

Three examples of DISKDEF macro invocations are shown below with 
corresponding STAT parameter values (the last produces a full 
8-megabyte system) . 

DISKDEF 0,1.5 8, ,20 48,256,128,128,2 
r=4096, k=512, d=128, c=128, e=256, b=16, s=58, t=2 

DISKDEF 0,1,58, ,2048,1024,300,0,2 
r=16384, k = 2048, d=300, c=0 , e=128, b=16, s=58, t=2 

DISKDEF 0,1,58, ,16384,512,128,128,2 
r=65536, k=8192, d=128, c=128, e=1024, b=128, s=58, t=2 



Append! 
G 
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12. SECTOR BLOCKING AND DEBLOCKING. 

Upon each call to the BIOS WRITE entry point, the CP/M BDOS 
includes information which allows effective sector blocking and 
deblocking where the host disk subsystem has a sector size which is a 
multiple of the basic 128-byte unit. The purpose here is to present a 
general-purpose algorithm which can be included within your BIOS which 
uses the BDOS information to perform the operations automatically. 

Upon each call to WRITE, the BDOS provides the following 
information in register C: 

= normal sector write 

1 = write to directory sector 

2 = write to the first sector 

of a new data block 

Condition occurs whenever the next write operation is into a 
previously written area, such as a random mode record update, when the 
write is to other than the first sector of an unallocated block, or 
when the write is not into the directory area. Condition 1 occurs 
when a write into the directory area is performed. Condition 2 occurs 
when the first record (only) of a newly allocated data block is 
written. In most cases, application programs read or write multiple 
128 byte sectors in sequence, and thus there is little overhead 
involved in either operation when blocking and deblocking records 
since pre-read operations can be avoided when writing records. 

Appendix G lists the blocking and deblocking algorithms in skeletal 
form (this file is included on your CP/M disk). Generally, the 
algorithms map all CP/M sector read operations onto the host disk 
through an intermediate buffer which is the size of the host disk 
sector. Throughout the program, values and variables which relate to 
the CP/M sector involved in a seek operation are prefixed by '*sek,*' 
while those related to the host disk system are prefixed by "hst. " 
The equate statements beginning on line 29 of Appendix G define the 
mapping between CP/M and the host system, and must be changed if other 
than the sample host system is involved. 

The entry points BOOT and WBOOT must contain the initialization 
code starting on line 57, while the SELDSK entry point must be 
augmented by the code starting on line 65. Note that although the 
SELDSK entry point computes and returns the Disk Parameter Header 
address, it does not physically selected the host disk at this point 
(it is selected later at READHST or WRITEHST) . Further, SETTRK, 
SETTRK, and SETDMA simply store the values, but do not take any other 
action at this point. SECTRAN performs a trivial trivial function of 
returning the physical sector number. 

The principal entry points are READ and WRITE, starting on lines 
110 and 125, respectively. These subroutines take the place of your 
previous READ and WRITE operations. 

The actual physical read or write takes place at either WRITEHST 
or READHST, where all values have been prepared: hstdsk is the host 

(All Information Contained Herein is Proprietary to Digital Research.) 

34 



disk number^ hsttrk is the host track number, and hstsec is the host 
sector number (which may require translation to a physical sector 
number) . You must insert code at this point which performs the full 
host sector read or write into, or out of, the buffer at hstbuf of 
length hstsiz. All other mapping functions are performed by the 
algorithms. 

This particular algorithm was tested using an 80 megabyte hard 
disk unit which was originally configured for 128 byte sectors, 
producing approximately 35 megabytes of formatted storage. When 
configured for 512 byte host sectors, usable storage increased to 57 
megabytes, with a corresponding 400% improvement in overall response. 
In this situation, there is no apparent overhead involved in 
deblocking sectors, with the advantage that user programs still 
maintain the (less memory consuming) 128-byte sectors. This is 
primarily due, of course, to the information provided by the BDOS 
which eliminates the necessity for pre-read operations to take place. 
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APPENDIX A: THE MDS COLD START LOADER 



0000 
ffff 
0000 



0000 = 

0000 = 

0806 = 

1880 = 

1600 = 

1603 = 

3000 

1880 = 

0002 = 
0031 = 
0019 = 
018 = 

f800 = 
ff0f = 

0078 = 

0079 = 
007b = 
007f = 

0078 = 

0079 = 
007a = 
00ff = 

0003 = 

0004 = 
0100 = 





MDS-bfeJiy 


cold Start 




Version 


2.0 August, 


false 


equ 





true 


equ 


not false 


testing 

• 


equ 


false 


/ 


if 


testing 


bias 


equ 
endif 


03400h 




if 


not testing 


bias 


equ 
endif 


0000h 


cpmb 


equ 


bias 


bdos 


equ 


806h+bias 


bdose 


equ 


1880h-fbias 


boot 


equ 


1600h+bias 


rboot 


equ 


boot+3 



1979 



mon80 

rmon80 

base 

rtype 

rbyte 

reset 

dstat 

ilow 

ihigh 

bsw 

recal 

readf 

stack 



org 



equ 
equ 
equ 
equ 
equ 
equ 

equ 
equ 
equ 
equ 
equ 
equ 
equ 



3000h 



;base of dos load 
;entrY to dos for calls 
;end of dos load 
;cold start entry point 
;warm start entry point 



;loaded here by hardware 



bdosl equ bdose-cpmb 

ntrks equ 2 

bdoss equ bdosl/128 

bdos0 equ 25 

bdosl eou bdoss-bdos0 



tracks to read 

# sectors in bdos 

# on track 

# on track 1 



0f800h 

0ff0fh 

7 8h 

base+1 

base+3 

base4-7 

base 

base+1 

base4-2 

0ffh 

3h 

4h 

100h 



Intel monitor base 
restart location for mon80 
'base' used by controller 
result type 
result byte 
reset controller 

disk status port 

low iopb address 

high iopb address 

boot switch 

recalibrate selected drive 

disk read function 

use end of boot for stack 



3000 310001 



3003 
3005 



3007 



b7 9 
b7b 



dbff 



^30 



rstart: 

Ixi 
; clear 

in 

in 
; check 
coldstart: 

in 

ani 
Jnz 



sp,stack;in case of call to mon80 
disk status 

rtype 

rbyte 
if boot switch is off 



bsw 
coldstart 



02b. ^ iswitch on? 
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300e d37f 



clear the controller 

out reset ;logic cleared 



3010 0602 
3012 214230 



mvi b,ntrks ;nuraber of tracks to read 
Ixi h,iopb0 



start! 



3015 7d 

3016 d379 

3018 7c 

3019 d3 7a 
301b db78 



3022 db79 
3024 e603 
3026 fe02 



wait0 : 



3028 d20030 



read first/next track into cpmb 

mov a,l 

out ilow 

mov a^h 

out ihigh 

in dstat 



am 



4 . 
wait0 



check disk status 



m 

ani 

cpi 

if 

cnc 

endif 

if 

jnc 

endif 



rtype 

lib 

2 

testing 

rmon80 ;qo to monitor if 11 or 10 

not testing 

rstart ;retry the load 



302b db7b 

302d 17 

302e dc0fff 

3031 If 

3032 e61e 



in rbyte ; i/o complete, check status 

if not ready, then go to mon80 

ral 

cc rmon80 ;not ready bit set 

rar ;restore 

ani 11110b ;over run/addr err/seek/crc 



3034 C20030 



if 

cnz 

endif 

if 

jnz 

endif 



testing 

rmon80 ;go to monitor 

not testing 

rstart ;retry the load 



3037 110700 

303a 19 

303b 05 

303c C21530 



303f C30016 



Ixi d^iopbl ;length of iopb 

dad d ; addressing next iopb 

dcr b ; count down tracks 

jnz start 



jmp boot, print message, set-up jmps 
jmp boot 

parameter blocks 
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3042 80 iopb0: db 

3043 04 db 

3044 19 db bdos0 ;# sectors to read trk 

3045 00 db 

3046 02 db 2 ;start with sector 2, trk 

3047 0000 dw cpmb ;start at base of bdos 
0007 = iopbl equ 

3049 80 iopbl: db 
304a 04 db 

304b 18 db bdosl ;sectors to read on track 1 

304c 01 db 

304d 01 db 

304e 800c dw cpmb+bdos0*128 ;base of second rd 

3050 end 



80h 


;iocw, no update 


readf 


;read function 


bdos0 


;# sectors to read 





; track 


2 


; start with sector 


cpmb 


;start at base of 


$-iopb0 




80h 




readf 




bdosl 


; sectors to read o 


1 


;track 1 


1 


; sector 1 
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APPENDIX B: THE MDS BASIC I/O SYSTEM (BIOS) 



0014 = 



4a00 
3400 
3c06 
1600 
2c 
0002 
0004 
0080 
000a 



vers 



cptnb 

bdos 

cpml 

nsects 

offset 

cdisk 

buff 

retry 



4a00 
4a03 
4a06 
4a09 
4a0c 



c3b34a 
c3c34a 
c3614b 
c3644b 
c36a4b 



wboote: 



mds-800 i/o drivers for cp/m 2,0 
(four drive single density version) 

version 2.0 august^ 1979 

equ 20 ;version 2.0 

copyright (c) 1979 
digital research 
box 579, pacific grove 
California, 93950 



org 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 

perform 
boot 
wboot 
(boot a 
const 



conin 

conout 

list 

punch 

reader 

home 



4a00h 

3400h 

3c06h 

$-cpmb 

cpml/128 

2 

0004h 

0080h 

10 



base of bios in 20k system 

base of cpm ccp 

base of bdos in 20k system 

length (in bytes) of cpm system 

number of sectors to load 

number of disk tracks used by cp 

address of last logged disk 

default buffer address 

max retries on disk i/o before e 



following functions 
cold start 

warm start (save i/o byte) 
nd wboot are the same for mds) 
console status 

reg-a = 00 if no character ready 
reg-a = ff if character ready 
console character in (result in reg-a) 
console character out (char in reg-c) 
list out (char in reg-c) 
punch out (char in reg-c) 
paper rape reader in (result to reg-a) 
move to track 00 



(the following calls set-up the io parameter bloc 
mds, which is used to perform subsequent reads an 
seldsk select disk given by reg-c (0,1,2...) 
settrk set track address (0,...76) for sub r/w 
setsec set sector address (1 ,... ,26) 
setdma set subsequent dma address (initially 80h 

read/write assume previous calls to set i/o parms 
read read track/sector to preset dma address 
write write track/sector from preset dma addres 



jump vector for 

jmp boot 

jmp wboot 

jmp const 

jmp conin 

jmp conout 



indiviual routines 
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4a0f 
4al2 
4al5 
4al8 
4alb 
4ale 
4a21 
4a24 
4a27 
4a2a 
4a2d 
4a30 



c36d4b 
c3724b 
c3754b 
c3784b 
c37d4b 
c3a74b 
c3ac4b 
c3bb4b 
c3cl4b 
c3ca4b 
c3704b 
c3bl4b 



4a33+= dpbase 

4a33+824a00 dpe0 : 

4a37+000000 

4a3b+6e4c73 

4a3f+0d4dee 

4a43+824a00 dpel: 

4a47+000000 

4a4b+6e4c73 

4a4f+3c4dld 

4a53+824a00 dpe2: 

4a57+000000 

4a5b+6e4c73 

4a5f+6b4d4c 

4a63+824a00 dpe3 : 

4a67+000000 

4a6b+6e4c73 

4a6f+9a4d7b 



4a73+= 

4a73+la00 

4a75+03 

4a76+07 

4a77+00 

4a78+f200 

4a7a+3f00 

4a7c+c0 

4a7d+00 

4a7e+1000 

4a80+0200 

4a82+= 

4a82+01 

4a8 3+0 7 

4a84+0d 

4a85+13 

4a86+19 

4a87+05 

4a88+0b 

4a89+ll 

4a8a+17 

4a8b+03 



dpb0 



xltii 



jmp 
jmp 
jnip 
jmp 
jmp 
jmp 
jmp 
jmp 
jmp 
jmp 
jmp 
jmp 

ma c 1 i b 

disks 

equ 

dw 

dw 

dw 

dw 

dw 

dw 

dw 

dw 

dw 

dw 

dw 

dw 

dw 

dw 

dw 

dw 

d i s kd e f 

equ 

dw 

db 

db 

db 

dw 

dw 

db 

db 

dw 

dw 

equ 

db 

db 

db 

db 

db 

db 

db 

db 

db 

db 



list 

punch 

reader 

home 

seldsk 

settrk 

setsec 

setdma 

read 

write 

listst 

sectran 



;list status 



d i s kd e 
4 

$ 

xlt0,0 

0000h, 

d i r bu f 

CSV0 ,a 

xltl,0 

0000h, 

d i r bu f 

csvl ,a 

xlt2,0 

0000h, 

d i r bu f 

csv2 ,a 

xlt3,0 

0000h, 

d i r bu f 

csv3 ,a 

0,1,26 

$ 

26 

3 

7 



24 2 

63 

192 



16 

2 

$ 

1 

7 

13 

19 

25 

5 

11 

17 

23 

3 



f ;load the disk definition library 
; f our disks 

;base of disk parameter blocks 
000h ;translate table 
0000h ;scratch area 
,dpb0 ;dir buff,parm block 
lv0 ;check, alloc vectors 
000h ;translate table 
0000h ;scratch area 
,dpbl ;dir buff,parm block 
Ivi ;check, alloc vectors 
000h ;translate table 
0000h ;scratch area 
,dpb2 ;dir buff,parm block 
lv2 ;check, alloc vectors 
000h ;translate table 
0000h jscratch area 
,dpb3 ;dir buff,parm block 
lv3 ;check, alloc vectors 
,6, 1024, 243, 64, 64, off set 

disk parm block 

sec per track 

block shift 

block mask 

extnt mask 

disk size-1 

directory max 

alloc0 

allocl 

check size 

offset 

translate table 
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4a8c+09 




db 


9 


4a8d+0f 




db 


15 


4a8e+15 




db 


21 


4a8f+02 




db 


2 


4a90+08 




db 


8 


4a91+0e 




db 


14 


4a92+14 




db 


20 


4a93+la 




db 


26 


4a94+06 




db 


6 


4a95+0c 




db 


12 


4a96+12 




db 


18 


4a97+18 




db 


24 


4a98+04 




db 


4 


4a99+0a 




db 


10 


4a9a+10 




db 


16 


4a9b+16 




db 


22 






diskdef 


1,0 


4a73+= 


dpbl 


egu 


dpb0 


001f+= 


alsl 


egu 


als0 


0010+= 


cssl 


equ 


CSS0 


4a82+= 


xltl 


egu 


xlt0 






diskdef 


2,0 


4a73+= 


dpb2 


egu 


dpb0 


001f+= 


als2 


egu 


als0 


0010+= 


css2 


egu 


CSS0 


4a82+= 


xlt2 


egu 


xlt0 






diskdef 


3,0 


4a73+= 


dpb3 


equ 


dpb0 


001f+= 


als3 


equ 


als0 


0010+= 


css3 


equ 


CSS0 


4a82+= 


xlt3 


equ 


xlt0 




• 


endef occurs 



00fd 
00fc 
00f3 
007e 



revr t 
intc 
icon 
inte 



;eguivalent parameters 
;same allocation vector size 
;same checksum vector size 
;same translate table 

;eguivalent parameters 
;same allocation vector size 
;same checksum vector size 
;same translate table 

;equivalent parameters 
;same allocation vector size 
;same checksum vector size 
;same translate table 
at end of assembly 



end of controller - independent code, the remaini 
are tailored to the particular operating environm 
be altered for any system which differs from the 

the following code assumes the mds monitor exists 
and uses the i/o subroutines within the monitor 

we also assume the mds system has four disk drive 

equ 0fdh ; interrupt revert port 

equ 0fch ; interrupt mask port 

egu 0f3h ; interrupt control port 

egu 0111$1110b;enable rst (warm boot) ,rst 7 



f800 
ff0f 
f803 
f806 
f809 
f80c 
f80f 
f812 



; mds monitor eguates 

mon80 egu 0f800h ;mds monitor 

rmon80 egu 0ff0fh ;restart mon80 (boot error) 

ci egu 0f803h ;console character to reg-a 

ri egu 0f806h ;reader in to reg-a 

CO egu 0f809h ;console char from c to console o 

po egu 0f80ch ;punch char from c to punch devic 

lo egu 0f80fh ;list from c to list device 

csts egu 0f812h ;console status 00/ff to register 
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disk ports and commands 



0078 


= 


base 


equ 


0078 


= 


dstat 


equ 


0079 


= 


rtype 


equ 


007b 


:= 


rbyte 

• 


equ 


0079 


= 


f 

ilow 


equ 


007a 


=: 


ihigh 


equ 


0004 


=: 


readf 


equ 


0006 


= 


wr itf 


equ 


0003 


= 


recal 


equ 


0004 


= 


iordy 


equ 


000d 


=r 


cr 


equ 


000a 


= 


If 

• 


equ 






signon: 


; si< 


4a9c 


0d0a0a 




db 


4a9f 


3230 




db 


4aal 


6b2043f 


db 


4aad 


322e30 




db 


4ab0 


0d0a00 




db 



78h 
base 
base+1 
base+3 

base+1 
base+2 

4h 

6h 

3h 

4h 

0dh 

0ah 



base of disk command io ports 
disk status (input) 
result type (input) 
result byte (input) 

iopb low address (output) 
iopb high address (output) 

read function 
write function 
recalibrate drive 
i/o finished mask 
carriage return 
line feed 



; signon message : xxk cp/m vers y.y 
cr,lf,lf 

•20* ; sample memory size 
' k cp/m vers * 

vers/10+*0' , • . • .vers mod 10+'0' 
cr.lf .0 

boot: ;print signon message and go to ccp 

; (note: mds boot initialized iobyte at 0003h) 

4ab3 310001 Ixi sp,buff+80h 

4ab6 219c4a Ixi h, signon 

4ab9 cdd34b call prmsg ;print message 

4abc af xra a ;clear accumulator 

4abd 320400 sta cdisk ;set initially to disk a 

4ac0 c30f4b jmp gocpm ;go to cp/m 



wboot: 



4ac3 318000 

4ac6 0e0a 
4ac8 c5 

4ac9 010034 
4acc cdbb4b 
4acf 0e00 
4adl cd7d4b 
4ad4 0e00 
4ad6 cda74b 
4ad9 0802 
4adb cdac4b 



wboot0 ; 



loader on track 0, sector 1, which will be skippe 
read cp/m from disk - assuming there is a 128 byt 
start. 



Ixi 



sprbuff ;using dma - thus 80 thru ff ok f 



mvi c, retry ;max retries 

push b 

;enter here on error retries 

Ixi b.cpmb ;set dma address to start of disk 

setdma 

c,0 ;boot from drive 

seldsk 

c,0 

settrk ;start with track 

;start reading sector 2 



call 

mvi 

call 

mvi 

call 

mvi 

call 



c,2 
setsec 



4ade cl 
4adf 062c 



read sectors, count nsects to zero 
pop b ;10-error count 
mvi b. nsects 
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rdsec: 



4ael 


c5 


4ae2 


cdcl4b 


4ae5 


c2494b 


4ae8 


2a6c4c 


4aeb 


118000 


4aee 


19 


4aef 


44 


4af0 


4d 


4afl 


cdbb4b 


4af4 


3a6b4c 


4af7 


fela 


4af9 


da054b 


4afc 


3a6a4c 


4aff 


3c 


4b00 


4f 


4b01 


cda74b 


4b04 


af 


4b05 


3c 


4b06 


4f 


4b07 


cdac4b 


4b0a 


cl 


4b0b 


05 


4b0c 


c2el4a 



4b0f 
4bl0 
4bl2 
4bl4 
4bl5 
4bl7 
4bl9 
4blb 
4blc 



f3 

3el2 

d3fd 

af 

dSfc 

3e7e 

d3fc 

af 

d3f3 



4b24 
4b26 
4b29 
4b2c 
4b2f 
4b32 
4b35 
4b38 
4b3b 
4b3e 



3ec3 

320000 

21034a 

220100 

320500 

21063c 

220600 

323800 

2100f8 

223900 



rdl; 



gocpm: 



4ble 018000 
4b21 cdbb4b 



; read 

push 

call 

jnz 

Ihld 

Ixi 

dad 

inov 

mov 

call 

Ida 

cpi 

jc 

must 

Ida 

inr 

mov 

call 

xra 

inr 

mov 

call 

pop 

dcr 

jnz 



next sector 

b ;save sector count 

read 

booterr ;retry if errors occur 

iod ; increment dma address 

;sector size 

; incremented dma address in hi 



d,128 
d 

b,h 
c,l 

setdma 
ios 
26 
rdl 
be sector 26, zero and go to next track 
iot ;get track to register a 



; ready for call to set dma 

;sector number just read 
;read last sector? 



a 

c^a 

settrk 

a 

a 

c,a 

setsec 

b 

b 

rdsec 



;ready for call 

;clear sector number 
;to next sector 
;ready for call 

; recall sector count 
;done? 



done with the load, reset default buffer address 
; (enter here from cold start boot) 
enable rst0 and rst7 
di 

; initialize command 



mvi 
out 
xra 
out 
mvi 
out 
xra 
out 



a,12h 
revr t 
a 

into 
a, inte 
into 
a 
icon 



;cleared 

;rst0 and rst7 bits on 



; interrupt control 



set default buffer address to 80h 
Ixi b,buff 
call setdma 

reset monitor entry points 



;jmp wboot at location 00 



mvi 


a,]mp 


sta 





Ixi 


h,wboote 


shld 


1 


sta 


5 


Ixi 


h,bdos 


shld 


6 


sta 


7*8 


Ixi 


h,inon80 


shld 


7*8+1 



;jmp bdos at location 5 

;jmp to mon80 (may have been chan 



■ 



leave iobyte set 
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4b41 
4b44 
4b45 
4b46 



4b49 
4b4a 
4b4b 

4b4e 
4b4f 



3a0400 
4f 
fb 
C30034 



cl 
0d 
ca524b 

c5 
c3c94a 



booterr ; 



previously selected disk was b, send parameter to 

ida cdisk ;last logged disk number 

mov c,a ;send to ccp to log it in 

ei 

jmp cpmb 

error condition occurred, print message and retry 



pop b 

dcr c 

jz booter0 

try again 

push b 

jmp wboot0 



; recall counts 



booter0 



4b52 
4b55 
4b58 



215b4b 
cdd34b 
c30fff 



otherwise too many retries 

Ixi h^bootmsg 

call prmsg 

jmp rmon80 ;mds hardware monitor 



4b5b 3f626f4 



bootmsg : 



db 



•?boof ,0 



4b61 c312f8 



const: ;console status to reg-a 
; (exactly the same as mds call) 
jmp csts 



conin: ;console character to reg-a 

4b64 cd03f8 call ci 

4b67 e67f ani 7fh ;remove parity bit 

4b69 c9 ret 



4b6a c309f8 



4b6d c30ff8 



conout: 



list: 



listst: 



4b70 
4b71 



af 
c9 



4b72 c30cf8 



4b75 c306f8 



punch: 



reader: 



;console character from c to console out 
jmp CO 

; list device out 

(exactly the same as mds call) 

j mp 1 o 



;return list status 

xra a 

ret ;always not ready 

;punch device out 

(exactly the same as mds call) 

jmp po 

;reader character in to reg-a 
(exactly the same as mds call) 
jmp ri 



home: ;move to home position 
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; treat as track 00 seek 

4b78 0e00 mvi c,0 

4b7a c3a74b jmp settrk 

seldsk: ; select disk given by register c 

4b7d 210000 Ixi h,0000h ;return 0000 if error 

4b80 79 mov a,c 

4b81 fe04 cpi ndisks ;too large? 

4b83 d0 rnc ;leave hi = 0000 



4b84 
4b86 
4b89 
4b8a 
4b8c 
4b8d 
4b90 

4b92 
4b93 
4b96 
4b97 
4b99 
4b9a 



e602 

32664c 

79 

e601 

b7 

ca924b 

3e30 

47 

21684c 

7e 

e6cf 

b0 

77 



im ^§00 

4b9e 29 



4b9f 
4ba0 
4bal 
4ba2 
4ba5 
4ba6 



29 

29 

29 

11334a 

19 

c9 



am 
sta 
mov 
ani 
ora 

jz 

mvi 

setdrive: 

mov 

Ixi 

mov 

ani 

ora 

mov 

mov 
mvi 

dad 

dad 

dad 

dad 

Ixi 

dad 

ret 



10b 

dbank 

a,c 

lb 

a 

setdrive 

a, 00110000b 



;00 00 for drive 0,1 and 10 10 fo 

; to select drive bank 

;00, 01, 10, 11 

;mds has 0,1 at 78, 2,3 at 88 

;result 00? 



; selects drive 1 in bank 



;save the function 
;io function 



b,a 

h,iof 

a,m 

11001111b ;mask out disk number 

b ;mask in new disk number 

m,a ;save it in iopb 

h 

h 

h 

h 

d,dpbase 

d ;hl=disk header table address 



;hl=disk number 

;*2 

;*4 

;*8 

;*16 



settrk: 



4ba7 216a4c 
4baa 71 
4bab c9 



; set 
Ixi 
mov 
ret 



track address 
h,iot 
m,c 



given by c 



4bac 216b4c 
4baf 71 
4bb0 c9 



4bbl 0600 

4bb3 eb 

4bb4 09 

4bb5 7e 

4bb6 326b4c 



setsec: ;set sector number given by c 



Ixi 

mov 
ret 



sectran: 



mil: 



mvi 

xchg 

dad 

mov 

sta 

mov 
ret 



h, ios 
m^c 



; translate sector be using table at de 
b^0 ;double precision sector number 

;translate table address to hi 
b ; translate (sector) address 
a^m ; translated sector number to a 
ios 
l^a ;return sector number in 1 
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setdma: ;set dma address given by regs b,c 
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4bbb 


69 


4bbc 


60 


4bbd 


226c4c 


4bc0 


c9 


4bcl 


0604 


4bc3 


cde04b 


4bc6 


cdf 04b 


4bc9 


c9 



mov 
mov 
shld 
ret 



iod 



read: ;read next disk record (assuming disk/trk/sec/dmc 

mvi c.readf ;set to read function 

call setfunc 

call waitio ;perform read function 

ret ;niay have error set in reg-a 



write: ;disk write function 



4bca 


0606 


mvi 


4bcc 


cde04b 


call 


4bcf 


cdf04b 


call 


4bd2 


c9 


ret 



4bd3 7e 
4bd4 b7 
4bd5 c8 



4bd6 
4bd7 
4bd8 
4bdb 
4bdc 
4bdd 



4be0 
4be3 
4be4 
4be6 
4be7 



4be8 
4bea 
4bed 
4bee 
4bef 



e5 

4f 

cd6a4b 

el 

23 

c3d34b 



21684c 

7e 

e6f8 

bl 

77 



e620 

216b4c 

b6 

77 

c9 



prmsg 



c^writf 

setfunc ;set to write function 

waitio 

;may have error set 



utility subroutines 

;print message at h,l to 

mov a,m 

or a a ;zero? 

rz 

more to print 

push h 

mov c^a 

call conout 

pop h 

inx h 

jmp prmsg 



setfunc: 



set function 
Ixi h^iof 
mov a,m 
ani 11111 
ora c 
mov m^a 
the mds-800 c 
mask the bit 
ani 00100 
Ixi h^ios 
ora m 
mov m,a 
ret 



for next i/o (command in reg-c) 
;io function address 
;get it to accumulator for maskir 
000b ; remove previous command 
;set to new command 
; replaced in iopb 
ontroller req's disk bank bit in sec 
from the current i/o function 
000b ;mask the disk select bit 
;address the sector selec 
;select proper disk bank 
;set disk select bit on/c 



4bf0 0e0a 



4bf2 cd3f4c 
4bf5 cd4c4c 

4bf8 3a664c 



waitio: 



rewait: 



mvi 



c, retry ;max retries before perm error 



start the i/o function and wait for completion 

call intype ;in rtype 

call inbyte ;clears the controller 



Ida 



dbank 



;set bank flags 
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4bfb b7 
4bfc 3e67 
4bfe 064c 
4c00 c20b4c 
4c03 d379 
4c05 78 
4c06 d37a 
4c08 c3104c 



iodrl: 



4c0b d389 
4c0d 78 
4c0e d38a 

t 

4cl0 cd594c wait0 
4cl3 e604 
4cl5 cal04c 



4cl8 cd3f4c 



4clb fe02 
4cld ca324c 



4c20 b7 
4c21 c2384c 



4c24 cd4c4c 
4c27 17 
4c28 da324c 
4c2b If 
4c2c e6fe 
4c2e c2384c 



ora a ;zero if drive 0,1 and nz 

mvi a,iopb and 0ffh ;low address for iopb 

mvi b,iopb shr 8 ;high address for iopb 

jnz iodrl ;drive bank 1? 

out ilow ;low address to controlle 

mov a,b 

out ihigh ;high address 

jmp wait0 



; drive bank 1 
out ilow+10h 
mov a,b 
out ihigh4-10h 



call 

ani 

jz 



instat 

iordy 

wait0 



;to wait for complete 
;88 for drive bank 10 



;wait for completion 
; ready? 



check io completion ok 

call intype ;must be io complete (00) 

00 unlinked i/o complete, 01 linked i/o comple 

10 disk status changed 11 (not used) 

cpi 10b ;ready status change? 

jz wready 

must be 00 in the accumulator 

ora a 

jnz werror ;some other condition, re 



check i/o error bits 

call inbyte 

ral 

jc wready 

rar 

ani 11111110b 

jnz werror 



;unit not ready 
;any other errors? 



4c31 c9 



read or write is ok, accumulator contains zero 
ret 



wready: ;not ready, treat 
4c32 cd4c4c call inbyte 
4c35 c3384c jnip trycount 



as 



error for 
;clear 



now 
result 



byte 



werror: ;return hardware malfunction (crc, track, seek, e 

the mds controller has returned a bit in each pos 
of the accumulator, corresponding to the conditio 

- deleted data (accepted as ok above) 

1 - crc error 

2 - seek error 

3 - address error (hardware malfunction) 

4 - data over/under flow (hardware malfunct 

5 - write protect (treated as not ready) 

6 - write error (hardware malfunction) 

7 - not ready 
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(accumulator bits are numbered 76543210) 



4c38 0d 
4c39 c2f24b 



trycount; 



it may be useful to filter out the various condit 
but we will get a permanent error message if it i 
recoverable, in any case^ the not ready conditio 
treated as a separate condition for later improve 

register c contains retry county decrement 'til z 

dcr c 

jnz rewait ;for another try 



4c3c 3e01 
4c3e c9 



cannot recover from error 
mvi a,l ;error code 
ret 



4c3f 3a664c 

4c4 2 b7 

4c43 c2494c 

4c46 db79 

4c48 c9 

4c49 db89 

4c4b c9 



; intype, inbyte, instat read drive bank 00 or 10 

intype: Ida dbank 

ora a 

jnz intypl ;skip to bank 10 

in i^type 

ret 

intypl: in rtype+10h ;78 for 0,1 88 for 2,3 

ret 



4c4c 3a664c inbyte: Ida dbank 

4c4f b7 ora a 

4c50 c2564c jnz inbytl 

4c53 db7b in rbyte 

4c55 c9 ret 

4c56 db8b inbytl: in rbyte+10h 

4c58 c9 ret 



4c59 3a664c instat: 

4c5c b7 

4c5d c2634c 

4c60 db78 

4c62 c9 

4c63 db88 instal: 

4c65 c9 



4c66 00 



4c67 
4c68 
4c69 
4 c 6a 
4c6b 
4c6c 



80 
4 
01 
02 
01 
8000 



dbank: 

iopb: 

iof : 
ion: 
iot: 
ios: 
iod: 



Ida 

ora 

jnz 

in 

ret 

in 

ret 



data 
db 



dbank 
a 

instal 
dstat 

dstat4-10h 



;io 

db 
db 
db 
db 
db 
dw 



areas (must be in ram) 
;disk bank 00 

10 
parameter block 



if 
if 



drive 
drive 



0rl 
2,3 



80h ;normal i/o operation 

readf ;io function, initial 

1 ;number of sectors to 

offset ;track number 

1 ; sector number 

buff ; io address 



read 
read 



define ram areas for bdos operation 
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endef 




4c6e+= 


begdat 


equ 


$ 


4c6e+ 


dirbuf : 


ds 


128 ;directorY access buffer 


4cee+ 


alv0: 


ds 


31 


4d0d+ 


CSV0 : 


ds 


16 


4dld+ 


alvl: 


ds 


31 


4d3c+ 


csvl: 


ds 


16 


4d4c+ 


alv2: 


ds 


31 


4d6b+ 


csv2 : 


ds 


16 


4d7b+ 


alv3: 


ds 


31 


4d9a+ 


csv3 : 


ds 


16 


4daa+= 


enddat 


equ 


$ 


013c+= 


datsiz 


equ 


$-begdat 


4daa 




end 





Append 
G 
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APPENDIX C; 



A SKELETAL CBIOS 



0014 = 



msize 



0000 
3400 
3c06 
4a00 
Q0id4 
0003 

4a00 
002c 



4a00 
4a03 
4a06 
4a09 
4a0c 
4a0f 
4al2 
4al5 
4al8 
4alb 
4ale 
4a21 
4a24 
4a27 
4a2a 
4a2d 
4a30 



c39c4a 
c3a64a 
c3114b 
c3244b 
c3374b 
c3494b 
c34d4b 
c34f4b 
c3544b 
c35a4b 
c37d4b 
c3924b 
c3ad4b 
c3c34b 
c3d64b 
c34b4b 
c3a74b 



bias 

ccp 

bdos 

bios 

cdisk 

iobyte 



nsects 



wboote; 



4a33 734a00 

4a37 000000 

4a3b f04c8d 

4a3f ec4d70 

4a43 734a00 
4a47 000000 
4a4b f04c8d 
4a4f fc4d8f 

4a53 734a00 
4a57 000000 
4a5b f04c8d 
4a5f 0c4eae 



dpbasej 



skeletal cbios for first level of cp/m 2.0 altera 

equ 20 ;cp/m version memory size in kilo 

"bias" is address offset from 3400h for memory sy 
than 16k (referred to as "b" throughout the text) 

equ (msize-20) *1024 

equ 3400h+bias ;base of ccp 

equ ccp+806h ;base of bdos 

equ ccp+1600h ;base of bios 

equ 0004h ;current disk number 0=ar...rl5=p 

equ 0003h ;intel i/o byte 



org 
equ 

jump 

jmp 

jmp 

jmp 

jmp 

jmp 

jmp 

jmp 

jmp 

jmp 

jmp 

jmp 

jmp 

jmp 

jmp 

jmp 

jmp 

jmp 



bios ; origin 
($-ccp)/128 



of this program 

;warm start sector count 



vector for 
boot 
wboot 
const 
conin 
conout 
list 
punch 
reader 
home 
seldsk 
settrk 
setsec 
setdma 
read 
write 
listst 
sectran 



individual subroutines 
cold start 

iwarm start 
console status 
console character in 
console character out 
list character out 
punch character out 
reader character out 

imove head to home positi 
select disk 
set track number 
set sector number 
set dma address 
read disk 
write disk 
return list status 
sector translate 



fixed data tables for four-drive standard 

ibm-compatible 8" disks 

disk parameter header for disk 00 

dw trans, 0000h 

dw 0000h,0000h 

dw dirbf^dpblk 

dw chk00,ail00 

disk parameter header for disk 01 

dw trans, 0000h 

dw 0000h,0000h 

dw dirbf,dpblk 

dw chk01,ail01 

disk parameter header for disk 02 

dw trans, 0000h 

dw 0000h,0000h 

dw dirbf,dpblk 

dw chk02,all02 
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• 

r 


disk p 


arameter header for disk 03 


4a63 


734a00 




dw 


trans, 0000h 




4a67 


000000 




dw 


0000h,0000h 




4a6b 


f04c8d 




dw 


dirbf, dpblk 




4a6f 


lc4ecd 




dw 


chk03,all03 








• 


sector 


translate vector 




Ji?^ mm 


trans: 


3fe 
do 


hW,h]h 


:il8l8^i J;g;^;i 


4a7b 


170309 




db 


23,3,9,15 


'Sectors 9,10,11,12 


4a7f 


150208 




db 


21,2,8,14 


►sectors 13,14,15,16 


4a83 


141a06 




db 


20,26,6,12 ; 


sectors 17,18,19,20 


4a87 


121804 




db 


18,24,4,10 ; 


sectors 21,22,23,24 


4a8b 


1016 




db 


16,22 


'Sectors 25,26 






dpblk: 


;disk ^ 


parameter block, common to all disks 


4a8d 


la00 




dw 


26 ; 


sectors per track 


4a8f 


03 




db 


3 ; 


block shift factor 


4a90 


07 




db 


7 ; 


block mask 


4a91 


00 




db 


; 


null mask 


4a92 


f200 




dw 


242 ; 


•disk size-1 


4a94 


3f00 




dw 


63 ; 


•directory max 


4a96 


C0 




db 


192 


•alloc 


4a97 


00 




db 





•alloc 1 


4a98 


1000 




dw 


16 


•check size 


4a9a 


0200 




dw 


2 


?track offset 



4a9c 
4a9d 
4aa0 
4aa3 

4aa6 
4aa9 
4aab 
4aae 



boot: 



af 

320300 
320400 
c3ef4a 

318000 
0e00 
cd5a4b 
cd544b 



wboot: 



end of fixed tables 

individual subroutines to perform each function 
;simplest case is to just perform parameter initi 



xra 

sta 
sta 
jmp 



a 

i o by t e 

cdisk 

gocpm 



;zero in the accum 
;clear the iobyte 
;select disk zero 
;initialize and go to 



cp/ 



; simplest case 
Ixi sp,80h 
mvi c,0 
call seldsk 
call home 



is to read the disk until all sect 
;use space below buffer f 
;select disk 

;go to track 00 



4abl 062c 
4ab3 0e00 
4ab5 1602 



4ab7 210034 



4aba 
4abb 
4abc 
4abd 
4abe 
4acl 



c5 

d5 

e5 

4a 

cd924b 

cl 



loadl; 



mvi 
mvi 
mvi 
note 
^onta 
Ixi 
; load 
push 
push 
push 
mov 
call 
pop 



b,nsects ;b counts # of sectors to 

c,0 ;c has the current track 

d,2 ;d has the next sector to 

that we begin by reading track 0, sector 2 s 
ins the cold start loader, which is skipped 

h,ccp ;base of cp/m (initial lo 
one more sector 



b ; save sector count, cu 

d ;save next sector to r 

h ;save dma address 

c,d ;get sector address to 

setsec ;set sector address fr 

b ; recall dma address to 



rrent track 
ead 



reg 

om r 

b,c 



ister c 
egister 
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4ac2 c5 
4ac3 cdad4b 



4ac6 cdc34b 
4ac9 fe00 
4acb c2a64a 



4ace el 

4acf 118000 

4ad2 19 

4ad3 dl 

4ad4 cl 

4ad5 05 

4ad6 caef4a 



push b ; replace on stack for later recal 

call setdma ;set dma address from b,c 

drive set to 0, track set^ sector set, dma addres 

call read 

cpi 00h ;any errors? 

jnz wboot ;retry the entire boot if an erro 

no error, move to next sector 



pop 
Ixi 
dad 
pop 
pop 
dcr 
jz 



h 

d,128 

d 

d 

b 

b 

gocpm 



recall dma address 

dma=dma+128 

new dma address is in h,l 

recall sector address 

recall number of sectors remaini 

sectors=sectors-l 

transfer to cp/m if all have bee 



4ad9 14 
4ada 7a 
4adb felb 
4add daba4a 



4ae0 1601 
4ae2 0c 



4ae3 c5 
4ae4 d5 
4ae5 e5 
4ae6 cd7d4b 
4ae9 el 
4aea dl 
4aeb cl 
4aec c3ba4a 



4aef 3ec3 
4afl 320000 
4af4 21034a 
4af7 220100 

4afa 320500 
4afd 21063c 
4b00 220600 

4b03 018000 
4b06 cdad4b 

4b09 fb 
4b0a 3a0400 
4b0d 4f 
4b0e C30034 



gocpm: 



more sectors remain to load, check for track chan 

inr d 

mov a,d ;sector=27?r if so, change tracks 

cpi 27 

jc loadl ;carry generated if sector<27 

end of current track, go to next track 

mvi d,l ;begin with first sector of next 

inr c ; track=track+l 

save register state, and change tracks 
push b 



settrk ;track address set from register 



push 
push 
call 
pop 


d 
h 

settr 
h 


pop 
pop 
jmp 


d 
b 
loadl 



;for another sector 
end of load operation, set parameters and go to c 



mvi 
sta 
Ixi 
shld 

sta 
Ixi 

shld 

Ixi 
call 

ei 
Ida 
mov 
jmp 



a,0c3h ;c3 is a jmp instruction 

;for jmp to wboot 
h,wboote ;wboot entry point 

1 ;set address field for jmp at 

5 ;for jmp to bdos 

h,bdos ;bdos entry point 
6 



b,80h 
setdma 



cdisk 

c,a 

ccp 



;address field of jump at 5 to bd 
;default dma address is 80h 



;enable the interrupt system 

;get current disk number 

;send to the ccp 

;go to cp/m for further processin 
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4bll 

4b21 3e00 
4b23 c9 



const: 



simple i/o handlers (must be filled in by user) 
in each case, the entry point is provided, with s 
to insert your own code 

;console status, return 0ffh if character ready, 
ds 10h ;space for status subroutine 
mvi a,00h 
ret 



conin: ;console character into register a 

4b24 ds 10h ;space for input routine 

4b34 e67f ani 7fh ;strip parity bit 

4b36 c9 ret 

r 

conout: ;console character output from register c 

4b37 79 mov a,c ;get to accumulator 

4b38 ds 10h ; space for output routine 

4b48 c9 ret 

list: ;list character from register c 

4b49 79 mov a,c ;character to register a 

4b4a c9 ret ;null subroutine 

listst: ;return list status (0 if not ready, 1 if ready) 

4b4b af xra a ;0 is always ok to return 

4b4c c9 ret 

# 

punch: ;punch character from register c 

4b4d 79 mov a,c ;character to register a 

4b4e c9 ret ;null subroutine 



4b4f 3ela 
4b51 e67f 
4b53 c9 



4b54 0e00 
4b56 cd7d4b 
4b59 c9 



reader: ;read character into register a from reader devic 
mvi a,lah ;enter end of file for now (repla 
ani 7fh ;remember to strip parity bit 
ret 



i/o drivers for the disk follow 

for now, we will simply store the parameters away 

in the read and write subroutines 



home: ;move to the track 00 position of current drive 
; translate this call into a settrk call with param 

mvi c,0 ;select track 

call settrk 

ret ;we will move to 00 on first read 



4b5a 210000 

4b5d 79 

4b5e 32ef4c 

4b61 fe04 



seldsk: ;select disk given by register c 

Ixi h,0000h ;error return code 

mov a,c 

sta diskno 

cpi 4 ;must be between and 3 



m 
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4b63 d0 



4b64 

4b6e 
4b71 
4b72 
4b74 
4b75 
4b76 
4b77 
4b78 
4b7b 
4b7c 



3aef4c 

6f 

2600 

29 

29 

29 

29 

11334a 

19 

c9 



rnc 

disk 

ds 

compute 

Ida 

mov 

mvi 

dad 

dad 

dad 

dad 

Ixi 

dad 

ret 



;no carry if 4,5,... 
number is in the proper range 

10 ; space for disk select 

disk parameter header address 



proper 

diskno 

l,a 

h,0 

h 

h 

h 

h 

d,dpbase 



;l=disk number 0, 
;high order zero 
;*2 



1,2,3 



*4 
*16 



(size of each header) 



;hl=,dpbase (diskno*! 6) 



4b7d 
4b7e 
4b81 
4b91 



settrk: 



79 
32e94c 

c9 



; set 

mov 

sta 

ds 

ret 



track given 
a^c 
track 
10h 



by register c 



;space for track select 



4b92 
4b93 
4b96 
4ba6 



79 
32eb4c 

c9 



setsec: ;set sector given by register c 

a,c 

sector 
10h 



mov 
sta 
ds 
ret 



space for sector select 



sectran: 



4ba7 
4ba8 
4ba9 
4baa 
4bac 



eb 

09 

6e 

2600 

c9 



;translate the sector given by be using the 
;translate table given by de 



xchg 

dad 

mov 

mvi 

ret 



b 

1 ,m 
h,0 



hl=, trans 
hl=. trans (sector) 
1 = trans (sector) 
hl= trans (sector) 
with value in hi 



4bad 69 
4bae 60 
4baf 22ed4c 
4bb2 
4bc2 c9 



setdma: ;set dma address given by registers b and c 



mov 

mov 

shld 

ds 

ret 



l,c ;low order address 

h,b ;high order address 

dmaad ;save the address 

10h ; space for setting the dma addres 



4bc3 
4bd3 



4bd6 



read: ;perform read operation (usually this is similar 
; so we will allow space to set up read command, th 
; common code in write) 

ds 10h ;set up read command 
c3e64b jmp waitio ; to perform the actual i/o 

write: ;perform a write operation 

ds 10h ;set up write commanu 

waitio: ;enter here from read and write to perform the ac 
; operation. return a 00h in register a if the ope 
; properly, and 01h if an error occurs during the r 
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4be6 

4ce6 3e01 
4ce8 c9 



4ce9 


track: 


ds 


2 


4ceb 


sector: 


ds 


2 


4ced 


dmaad: 


ds 


2 


4cef 


diskno: 


ds 


1 




J 

• 
1 


scratch 


ram 


4cf0 = 


begdat 


equ 


$ 


4cf0 


dirbf : 


ds 


128 


4d70 


all00: 


ds 


31 


4d8f 


all01: 


ds 


31 


4dae 


all02: 


ds 


31 


4dcd 


all03: 


ds 


31 


4dec 


chk00: 


ds 


16 


4dfc 


chk01: 


ds 


16 


4e0c 


chk02: 


ds 


16 


4elc 


chk03: 


ds 


16 


4e2c = 


enddat 


equ 


$ 


013c = 


datsiz 


equ 


$-b 


4e2c 




end 





in this case, we have saved the disk number in "d 

the track number in 'track' (0-76 
the sector number in 'sector' (1- 
the dma address in 'dmaad' (0-655 

ds 256 ;space reserved for i/o drivers 

mvi a,l ;error condition 

ret ;replaced when filled-in 

the remainder of the cbios is reserved uninitiali 
data area, and does not need to be a part of the 
system memory image (the space must be available, 
however, between "begdat" and "enddat"). 



; two bytes for expansion 
;two bytes for expansion 
;direct memory address 
;disk number 0-15 

I for bdos use 
beginning of data area 
scratch directory area 



allocation vector 
allocation vector 
allocation vector 

allocation vector 
check vector 
check vector 1 
check vector 2 
check vector 3 



;end of data area 
$-begdat;size of data area 
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APPENDIX D: A SKELETAL GETSYS/PUTSYS PROGRAM 



0100 
0014 



msize 



combined getsys and putsys programs from Sec 4. 
Start the programs at the base of the TPA 



org 
egu 



0100h 
20 



; size of cp/m in Kbytes 



; *'bias" is the amount to add to addresses for > 20k 
; (referred to as "b" throughout the text) 



0000 = 


bias 


equ 


(msize-20) *1024 


3400 = 


ccp 


equ 


3400h+bias 


3c00 = 


bdos 


equ 


ccp+0800h 


4a00 = 


bios 


equ 


ccp+1600h 



0100 

0103 
0106 



318033 
218033 
0600 



0108 0e01 



010a 
010d 
0110 
0111 
0112 
0113 
0115 



cd0003 

118000 

19 

0c 

79 

felb 

da0a01 



gstart: 



rd$trk: 
rd$sec: 



getsys programs tracks and 1 to memory at 
3880h + bias 



register 
a 
b 
c 

d,e 
h,l 
sp 



usage 
(scratch register) 
track count (0...76) 
sector count (1...26) 
(scratch register pair) 
load address 
set to stack address 



Ixi 
Ixi 
mvi 

mvi 

call 

Ixi 

dad 

inr 

mov 

cpi 

jc 



sp,ccp-0080h 

h,ccp-0080h 

b,0 

c,l 

read$sec 

d,128 

d 

c 

a,c 

27 

rdsec 



start of getsys 
convenient plac 
set initial loa 
start with trac 
read next track 
each track star 

get the next se 
offset by one s 

(hl=hl+128) 
next sector 
fetch sector nu 

and see if la 
<r do one more 



; arrive here at end of track r move to next track 



0118 04 


inr 


b 


0119 78 


mov 


a,b 


011a fe02 


cpi 


2 


011c da0801 


jc 


rd$trk 



011f fb 
0120 76 



track = track+1 

check for last 

track = 2 ? 

<, do another 

; arrive here at end of load, halt for lack of anything b 

ei 
hit 
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putsys program, places memory image starting at 

3880h + bias back to tracks and 1 

start this program at the next page boundary 



0200 



0200 
0203 
0206 



org ($+0100h) and 0ff00h 



318033 
218033 
0600 



put$sys: 



0208 0e01 



wr$trk: 
wr$sec: 



020a 
020d 
0210 
0211 
0212 
0213 
0215 



0218 
0219 
021a 
021c 



021f 
0220 



cd0004 

118000 

19 

0c 

79 

felb 

da0a02 



04 
78 

fe02 
da0802 



fb 
76 



Ixi sp,ccp-0080h 

Ixi h,ccp-0080h 

mvi b,0 

mvi c,l 

call write$sec 

Ixi d,128 

dad d 

inr c 

mov a,c 

cpi 27 

jc wr$sec 



; convenient plac 
; start of dump 
; start with trac 

; start with sect 

write one secto 
length of each 
<hl>=<hl> + 128 
<c> = <c> + 1 
see if 

past end of t 
no, do another 



arrive here at end of track, move to next track 



inr 
mov 
cpi 
jc 



b 

a,b 
2 
wr$trk 



track = track+1 
see if 

last track 
no, do another 



done with putsys, halt for lack of anything bette 



ei 
hit 



0300 



0300 c5 

0301 e5 



0302 

0342 el 

0343 cl 



; user supplied subroutines for sector read and write 

; move to next page boundary 

org ($+0100h) and 0ff00h 
read$sec! 



; read the next sector 
; track in <b>, 
; sector in <c> 
; dmaaddr in <hl> 


push 
push 


b 
h 







; user defined read operation goes here 
ds 64 



pop 
pop 



h 
b 
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0344 c9 ret 

0400 org ($+0100h) and 0ff00h ; another page bo 
wr ite$sec: 

; same parameters as read$sec 

0400 c5 push b 

0401 e5 push h 

; user defined write operation goes here 

0402 ds 64 

4 42 el pop h 

0443 cl pop b 

0444 c9 ret 

; end of getsys/putsys program 

0445 end 
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APPENDIX E: A SKELETAL COLD START LOADER 



this is a sample cold start loader which, when modified 
resides on track 00, sector 01 (the first sector on the 
diskette) . we assume that the controller has loaded 
this sector into memory upon system start-up (this pro- 
gram can be keyed-in, or can exist in read/only memory 
beyond the address space of the cp/m version you are 
running) . the cold start loader brings the cp/m system 
into memory at "loadp" (3400h + "bias**). in a 20k 
memory system^ the value of "bias" is 0000h, with large 
values for increased memory sizes (see section 2). afte 
loading the cp/m system, the clod start loader branches 
to the "boot" entry point of the bios, which begins at 
"bios" + "bias." the cold start loader is not used un- 
til the system is powered up again, as long as the bios 
is not overwritten, the origin is assumed at 0000h, an 
must be changed if the controller brings the cold start 
loader into another area, or if a read/only memory area 
is used. 



0000 



org 







base of ram in cp/m 



0014 = 

0000 = 

3400 = 

4a00 = 

0300 = 

4a00 = 

1900 = 

0032 = 



msize 


equ 


bias 


equ 


ccp 


equ 


bios 


equ 


biosl 


equ 


boot 


equ 


size 


equ 


sects 


equ 



20 



min mem size in kbytes 



(msize-20) *1024 ; offset from 20k system 



3400h4-bias 

ccp+1600h 

0300h 

bios 

bios+biosl-ccp 

size/128 



base of the ccp 
base of the bios 
length of the bios 

size of cp/m system 
# of sectors to load 



begin the load operation 



cold: 



0000 


010200 


Ixi 


b,2 


0003 


1632 


mvi 


d, sects 


0005 


210034 


Ixi 


h,ccp 



b=0 , c=sector 2 
d=# sectors to load 
base transfer address 



Isect: 



load the next sector 



insert inline code at this point to 
read one 128 byte sector from the 
track given in register b, sector 
given in register c, 
into the address given by <hl> 

branch to location "cold" if a read error occurs 



^^ffl 
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************************************************* 

* user supplied read operation goes here... 
************************************************* 



0008 c36b00 
00b 



jmp past$patch 
ds 60h 



; remove this when patche 



006b 15 
006c ca004a 



past$patch: 

; go to next sector if load is incomplete 

dcr d ; sects=sects-l 

jz boot ; head for the bios 



; more sectors to load 

; we aren't using a stacks so use <sp> as scratch registe 
; to hold the load address increment 



006f 318000 


Ixi 


sp,128 


0072 39 


dad 


sp 


0073 0c 


inr 


c 


0074 79 


mov 


a,c 


0075 felb 


cpi 


27 


0077 da0800 


jc 


Isect 



; 128 bytes per sector 

; <hl> = <hl> + 128 

; sector = sector + 1 

; last sector of track? 

; nOr go read another 



; end of track, increment to next track 



007a 


0e01 


mvi 


c,l 


007c 


04 


inr 


b 


007d 


C30800 


jmp 


Isect 


0080 




end 





sector = 1 
track = track + 1 
for another group 
of boot loader 
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1 

2: 
3 
4 
5; 
6: 
7 
8 
9 
10; 

ll! 

12; 

13; 

14; 

15; 

16; 

17 

18 

19 

20; 

21: 

22: 

23! 

24; 

25; 

26; 

27; 

28; 

29 

30; 

3l! 

32; 
33; 
34; 
35; 
36; 
37; 
38; 
39; 
40; 

4l! 

42; 
43; 
44; 
45; 
46; 
47; 
48; 
49; 
50; 
51; 
52: 
53; 



APPENDIX F: CP/M DISK DEFINITION LIBRARY 

CP/M 2.0 disk re-definition library 

Copyright (c) 1979 

Digital Ratearch 

Box 579 

Pacific Grove, CA 

93950 

CP/M logiccl disk drives are defined using the 
macros given below, where the sequence of calls 
is: 

disks n 

diskdef paraineter-list-0 

diskdef parameter-list-l 

• • • 

diskdef parameter-list-n 
endef 

where n is the number of logical disk drives attached 
to the CP/M system, and parameter-list~i defines the 
characteristics of the ith drive (i=0 ,1 , • . • rn-1) 

each parameter-list-i takes the form 

dn,fsc,lsc, [skf] ,bls ,dkSr dir ,cks,of s, [0] 



where 

dn 

f sc 

Isc 

skf 

bis 

dks 

dir 

cks 

of s 

[0] 



IS 

is 
is 
is 
is 
is 
is 
is 
is 
is 



the disk number 0,1,..., n-1 
tiie first sector number (usually or 1) 
the last sector number on a track 
Ofcitional "skew factor" for sector translate 
tne data block size (1024 ,2048 ,... ,16384) 
disk size in bis increments (word) 
directory elements (word) 
dir elements to checksum 
tracks to skip (word) 
which forces i6K/directory en 



tne 
tne: 
the 
the 
an 



number of 

number of 

number of 

optional 



for convenience, the form 

dn,dm 
defines disk dn as having the same characteristics as 
a previously defined disk dm. 

a standard four drive CP/M system is defined by 

disks 4 

diskdef 0,1,26,6,1024,243,64,64,2 
dsk set 

rept 3 
dsk set dsk+1 

diskdef %dsk,0 

endm 

endef 

the value of "begdat" at the end of assembly defines t 
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54 

55 

56: 

57: 

58: 

59; 

60 

61; 

62; 

63: 

64: 

65: 

66 

67: 

68: 

69: 

70 

71 

72: 

73: 

74; 

7 5 
76: 
77 
78; 
79 
80 
81 
82; 
83; 
84 
85: 
86 

8 7 
88: 
89; 
90 
91 
92: 
93 
94; 
95: 
96 
97; 
98; 
99 

100; 
101; 
102; 
103; 
104; 
105; 
106: 
107: 
108; 



dskhdr 

• • 

dpe&dn: 



disks 

• • 

ndisks 

dpbase 

• • 

dsknxt 



dsknxt 



dpbhdr 
dpb&dn 



ddb 



ddw 



gcd 



gcdm 
gcdn 
gcdr 

gcdx 
gcdr 



beginning of the uninitialize ram area above the bios, 
while the value of "enddat" defines the next location 
following the end of the data area. the size of this 
area is given by the value of "datsiz" at the end of t 
assembly, note that the allocation vector will be qui 
large if a large disk size is defined with a small bio 
size. 



macro 

define 

dw 

dw 

dw 

dw 

endm 



dn 
a single disk 
xlt&dn,0000h 
0000h,0000h 
dirbuf rdpb&dn 
csv&dn,aiv&dn 



header list 

; translate table 
;scratch area 
;dir buff.parm block 
;check, alloc vectors 



macro nd 

define nd disks 

set nd ;;for later reference 

equ $ ;base of disk parameter blocks 

generate the nd elements 

set 

rept nd 

dskhdr %dsknxt 

set dsknxc+1 

endm 

endm 



macro 

equ 

endm 



dn 



;disk parm block 



macro data, comment 

define a db statement 

db data 
endm 

macro data, comment 

define a dw statement 

dw data 
endm 



comment 



comment 



macro m,n 

greatest common divisor of m,n 

produces value acdn as result 

(used in sector translate table generation) 



set 

set 

set 

rept 

set 

set 

if 

exitm 

endif 



m 

n 



65535 

gcdm/gcdn 

gcdm - gcdx*gcdn 

gcdr = 



; ;variable for m 
; ;variable for n 
; ;variable for r 
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109; 

110 

111; 

112: 

113; 

114; 

115; 

116; 

117; 

118 

119 

120; 

121; 

122: 

123: 

124; 

125; 

126; 

127; 

128 

129 

130; 

131; 

132; 

133; 

134; 

135 

136; 

137; 

138; 

139; 

140 

141; 

142; 

143; 

144; 

145; 

146 

147; 

148; 

149; 

150 

151; 

152; 

153; 

154; 

155; 

156; 

157; 

158; 

159; 

160; 

161; 

162; 

163; 



gcdm 
gcdn 



set 
set 
endm 
endm 



gcdn 
gcdr 



diskdef macro dn, f sc ,lsc ,sl<f ,bls,dks,dir ,cks,of s, kl6 
; ; generate the set statements for later tables 

if nul Isc 

current disk dn 

equ dpb&fsc 

equ als&fsc 

equ css&fsc 

equ xlt&fsc 

else 

set Isc-(fsc) ;;sectors 0...secmax 

set secmax+1; ; number of sectors 

set (dks)/8 ;;size of allocation vector 

if ( (dks) mod c) ne 

set als&dn+l 

endif 

set (cks)/4 ;;number of checksum elements 

generate the block shift value 

of sectors/block 
right 0's in blkval 
;i;ills with I's from right 
Tonce for eacn bit position 



dpb&dn 
als&dn 
css&dn 
xlt&dn 

secmax 

sectors 

als&dn 

als&dn 

css&dn 

• • 

blkval 
blkshf 
blkmsk 



same as previous fsc 
3auivalent parameters 
same allocation vector size 
same checksum vector size 
same translate table 



blkshf 
blkmsk 
blkval 



blkval 
extmsk 



r t 

extmsk 
Dlkval 



extmsk 



extmsk 



d i r r em 



bls/128 





16 

blkval=l 



; number 
; counts 



set 

set 

set 

rept 

if 

exitm 

endif 

otherwise, high order 1 not found y^t 

set blkshf+l 

set (blkmsk shl 1) or 1 

set blkval/2 

endm 

generate the extent mask byte 



bls/1024 ; ;number of kilobytes/block 

;;fiil from right with I's 

16 

blkval=l 



set 

set 

rept 

if 

exitm 

endif 

otherwise more to shift 

set (extmsk shl 1) or 

set blkval/2 

endm 

may be double 

if (dks) 

set (extmsk 

endif 

may be optional 

if not nul 

set kl6 

endif 

now generate directory 



byte allocation 
> 256 

1) 



shr 

[0] 
kl6 



in last position 



reservation bit vector 
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set 



dir 



;# remaining to process 
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164: dirbks set bls/32 ;;number of entries per block 

165: dirblk set ;;fill with I's on each loop 

166: rept 16 

167: if dirrem=0 

168: exitm 

169: endif 

170: ;; not complete, iterate once again 

171: ;; shift right and add 1 high order bit 

172: dirblk set (dirblk shr i) or 8000h 

173: if dirrem > dirbks 

174: dirrem set dirrem-dirbks 

175: else 

176: dirrem set 

177: endif 

178: endm 

179: dpbhdr dn ;;generate equ $ 

180: ddw %sectors, < ;sec per track> 

181: ddb %blkshf , < ;blcck ' shif t> 

182: ddb %blkmsk ,<; block mask> 

183: ddb %extmsk ,< ;extnt mask> 

184: ddw % (dks) -1 , < ;Qisk size-l> 

185: ddw % (dir ) -1 , < ;airectorY max> 

186: adb %dlrblk shr 8,<;alloc0> 

187: ddb %dirblk ana 0f f h, < ; allocl> 

188: ddw % (cks) /4 ,<; check size> 

189: ddw %of s, < ; of f set> 

190: ;; generate the translate table, if requested 

191: if nul skf 

192: xlt&dn equ ;no xlate taole 

193: else 

194: if skf = 

195: xlt&dn equ ;no xlate table 

196: else 

197: ;; generate the translate taole 

198: nxtsec set ;;iiext sector to fill 

199: nxtbas set ;;mcves by one on overflow 

200: gcd %sectors,skf 

201: ;; gcdn = gcd( sectors, skew) 

202: neltst set sectors/gcdn 

203: ;; neltst is number of elements to generate 

204: ;; before we overlap orevious elements 

205: nelts set neltst ;;cGunter 

206: xlt&dn equ $ ;translate table 

207: rept sectors ; ;once for each sector 

208: if sectors < 256 

209: ddb %nxtsec+ (f sc) 

210: else 

211: ddw %nxtsec+ (f sc) 

212: endif 

213: nxtsec set nxtsec+(skf) 

214: if nxtsec >= sectors 

215: nxtsec set nxtsec-sectors 

216: endif 

217: nelts set nelts-1 

218 : if nelts =0 
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219 

220; 

221; 

222! 

223; 

224; 

225; 

226; 

227: 

228; 

229 

230: 

231; 

232; 

233; 

234: 

235: 

236; 

237: 

238: 

239: 

240: 

241; 

242: 

243; 

244; 

245: 

246: 

247: 

248 

249; 



nxtbas 
nxtsec 
nelts 



defds 
lab: 



ids 



endet 

• • 
f r 

begdat 
d i r bu f : 
dsknxt 



dsknxt 

enddat 
datsiz 



set 

set 

set 

endif 

endm 

endif 

endif 

endm 

macro 

ds 

endm 

macro 
defds 
endm 



nxtbas+i 

nxtbas 

neltst 



; ;end of nul fac test 
;;end of nul bis test 



lab, space 
space 



lb,dn, val 
Ib&dn, %val&dn 



macro 

generate the necessary ram data areas 



jdirectory access buffer 



$ 
128 



ndisks ;;once for eacn disk 
alv,%dsknxt ,als 
csv,%dsknxt ,css 
dsknxt+1 



equ 

ds 

set 

rept 

Ids 

Ids 

set 

endm 

equ $ 

equ ?-begdat 

db at this point forces hex record 

endm 
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APPENDIX G: BLOCKING AND DEBLOCKING ALGORITHMS. 



1; 

2; 

3 

4 

5 

6 

7 

8 

9 
10: 
11: 
12; 
13; 
14; 
15; 
16; 
17; 
18 
19 
20 
21; 
22; 
23; 
24; 
25; 
26; 
27; 
28; 
29 
30; 
31; 
32; 
33; 
34; 
35; 
36; 
37; 
38; 
39; 
40; 
41; 
42: 
43; 
44; 
45; 
46; 
47; 
48; 
49; 
50: 
51; 
52; 
53; 



***************************************************** 

* * 

* Sector Deblocking Algorithms for CP/M 2.0 * 

* * 

***************************************************** 



utility macro to compute sector mask 
smask macro hblk 

compute log2(hblk), return ©x as result 

(2 ** gx = hblk on return) 

set hblk 

set 

count right shifts of @y until = 1 

rept 8 

if @y = 1 

exitm 

endif 

@y is not 1, shift right one position 

set @y shr 1 

set @x + 1 

endm 

endm 



« « 

@y 
@x 



@Y 
@x 



>ic*x** ********************** ************************** 

* * 

* CP/M to host disk constants * 

* * 

***************************************************** 



blksiz equ 

hstsiz equ 

hstspt equ 

hstblk equ 

cpmspt equ 

secmsk equ 

smask 

secshf equ 



2048 

512 

20 

hstsiz/128 

hstblk * hstspt 

hstblk-1 

hstblk 

@x 



CP/M allocation size 
host disk sector size 
host disk sectors/trk 
CP/M sects/host buff 
CP/M sectors/track 
sector mask 
compute sector mask 
log2 (hstblk) 



***************************************************** 

* * 

* BDOS constants on entry to write * 

* * 

***************************************************** 
wrall equ ;write to allocated 



wrdir 
wrual 



equ 
equ 
equ 



1 
2 



;write to directory 
;write to unallocated 



***************************************************** 

* * 

* The BDOS entry points given below show the * 

* code which is relevant to deblocking only, * 

* * 

***************************************************** 
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54: 

55; 

56; 

57; 

58; 

59; 

60; 

61; 

62; 

63; 

64 

65 

66 

67 

68: 

69 

70 

71; 

72; 

73; 

74: 

75; 

76: 

77: 

78: 

79: 

80: 

81: 

82; 

83: 

84; 

85; 

86: 

87: 

88: 

89; 

90: 

91 

92; 

93; 

94: 

95; 

96: 

97: 

98: 

99: 

100; 

101; 

102: 

103: 



; DISKDEF macro, or hand coded tables go here 
dpbase egu $ ;disk param block base 



boot: 
wboot: 



seldski 



settrk: 



setsec: 



setdma: 



;enter here on system boot to initialize 



xra 
sta 
sta 
ret 



a 

hstact 

unacnt 



to accumulator 
host buffer inactive 
clear unalloc count 



;select disk 



mov 

sta 

mov 

mvi 

rept 

dad 

endm 

Ixi 

dad 

ret 



a,c 

sekdsk 

l,a 

h,0 

4 

h 

d , dpbase 
d 



;selected disk number 
;seek disk number 
;disk number to HL 

;multiplY by 16 



;base of parm block 
;hl=.dpb(curdsk) 



;set track given by registers BC 

mov h,b 

mov l,c 

shld sektrk ;track to seek 

ret 



;set sector given by register c 

mov a,c 

sta seksec ;sector to seek 

ret 



;set dma address given by BC 

mov h,b 

mov l,c 

shld dmaadr 

ret 



sectran: 



;translate sector number BC 
mov h,b 
mov l,c 
ret 
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104; 
105; 

106! 

107i 

108! 
109! 
110! 
111! 
112! 
113! 

114: 

115! 

116: 

117: 

118: 

119 

120: 

121: 

122: 

123: 

124: 

125: 

126: 

127; 

128; 

129: 

130: 

131: 

132: 

133: 

134; 

135: 

136: 

137: 

138: 

139: 

140: 

141: 

142: 

143: 

144: 

145: 

146: 

147: 

148: 

149: 

150: 

151: 

152: 

153: 

154: 

155: 

156: 

157: 

158: 



***************************************************** 

* * 

* The READ entry point takes the place of * 

* the previous BIOS defintion for READ. * 

* " * 

***************************************************** 

read: 

;read the selected CP/M sector 

mvi a,l 

sta readop ;read operation 

sta rsflag ;must read data 

mvi a,wrual 

sta wrtype ; treat as unalloc 

jmp rwoper ;to perform the read 

***************************************************** 

* * 

* The WRITE entry point takes the place of * 

* the previous BIOS defintion for WRITE. * 

* * 

***************************************************** 

write: 

;write the selected CP/M sector 

xra a ;0 to accumulator 

sta readop ;not a read operation 

mov a,c ;write type in c 

sta wrtype 

cpi wrual ;write unallocated? 

jnz chkuna ;check for unalloc 



chkuna: 



write to unallocated, set parameters 

mvi a,blksiz/128 ;next unalloc recs 

sta unacnt 

Ida sekdsk ;disk to seek 

sta unadsk ;unadsk = sekdsk 

Ihld sektrk 

shld unatrk ;unatrk = sectrk 

Ida seksec 

sta unasec ;unasec = seksec 



;check for write to unallocated sector 

Ida unacnt ;any unalloc remain? 

ora a 

jz alloc ;skip if not 



more unallocated records remain 

dcr a 

sta unacnt 

Ida sekdsk 

Ixi h, unadsk 

cmp m 

jnz alloc 

disks are the same 



; unacnt = unacnt-1 

;same disk? 

;sekdsk = unadsk? 
;skip if not 
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159: 

160: 

161: 

162: 

163: 

164: 

165: 

166: 

167: 

168: 

169: 

170; 

171: 

172: 

173: 

174: 

175: 

176: 

177: 

178: 

179: 

180; 

181; 

182: 

183; 

184; 

185: 

186: 

187: 

188: 

189: 

190 

191 

192 

193; 

194; 

195; 

196; 

197; 

198; 

199 

200: 

201: 

202: 

203: 

204: 

205: 

206; 

207: 

208: 

209: 

210; 

211: 

212: 

213: 



Ixi 

call 

jnz 



h^unatrk 

sektrkcmp 

alloc 



tracks are the same 

Ida seksec 

Ixi h.unasec 

cro m 

jnz alloc 



;sektrk = unatrk? 
;skip if not 



;same sector? 

;seksec = unasec? 
?skip if not 



match, move to next sector for future ref 



inr 
mov 
cpi 
jc 



m 

a,m 

cpmspt 
noovf 



overflow to next track 
mvi m,0 
Ihld unatrk 
inx h 
shld unatrk 



;unasec = unasec+1 
;end of track? 
;count CP/M sectors 
;skip if no overflow 



;unasec = 
;unatrk = unatrk+1 



noovf : 



alloc: 



;match found, mark as unnecessary read 

xra a ;0 to accumulator 

sta rsflag ;rsflag = 

jmp rwoper ;to perform the write 



;not an unallocated record, requires pre-read 



xra 
sta 
inr 
sta 



a 

unacnt 
a 
rsflag 



to accum 
unacnt = 

1 to accum 
rsflag = 1 



************************* itie ************************** 
* * 

* Common code for READ and WRITE follows * 

* * 

***************************************************** 

rwoper: 

;enter here to perform the read/write 



xra 

sta 

Ida 

rept 

ora 

rar 

endm 

sta 



a 

erflag 

seksec 

secshf 

a 



sekhst 



active host sector? 
Ixi h,hstact 
mov a,m 
mvi m,l 



;zero to accum 
;no errors (yet) 
;compute host sector 

;carry = 
;shift right 

;host sector to seek 



;host active flag 
; always becomes 1 
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214: 




ora 


a 


;was it already? 


215: 




jz 


filhst 


;fill host if not 


216: 


• 








217: 


• 
1 


host 


buffer active, same as seek buffer? 


218: 




Ida 


sekdsk 




219: 




Ixi 


h,hstdsk 


;same disk? 


220: 




cmp 


m 


; sekdsk = hstdsk? 


221: 




jnz 


nomatch 




222: 


• 








223: 


• 
1 


same 


disk, same track? 


224: 




Ixi 


h,hsttrk 




225: 




call 


sektrkcmp 


;sektrk = hsttrk? 


226: 




jnz 


nomatch 




227: 


• 








228: 


• 


same 


disk , same track 


, same buffer? 


229: 




Ida 


sekhst 




230: 




Ixi 


h,hstsec 


; sekhst = hstsec? 


231: 




cmp 


m 




232: 




jz 


match 


;skip if match 


233: 


• 








234: 


nomatch 


• 
• 






235: 




;proper disk, but not 


correct sector 


236: 




Ida 


hstwrt 


;host written? 


237! 




ora 


a 




238: 




cnz 


writehst 


;clear host buff 


239: 


• 

9 








240: 


' filhst: 








241: 




;maY 


have to fill the 


host buffer 


242; 




Ida 


sekdsk 




243; 




sta 


hstdsk 




244 




Ihld 


sektrk 




245 




shld 


hsttrk 




246 




Ida 


sekhst 




247; 




sta 


h St sec 




248: 




Ida 


rsflag 


;need to read? 


249" 




ora 


a 




250! 




cnz 


readhst 


;yes, if 1 


25l! 




xra 


a 


;0 to accum 


252! 




sta 


hstwrt 


;no pending write 


253! 


» • 








254 


: match: 








255 




;copy data to or from 


buffer 


256 




Ida 


seksec 


;mask buffer numbe 


257 




ani 


secmsk 


;least signif bits 


258 




mov 


Ira 


;ready to shift 


259 




mvi 


h,0 


; double count 


260 




rept 


7 


;shift left 7 


261 




dad 


h 




262 




endm 






263 


• • 

• r 


hi has relative host 1 


buffer address 


264 




Ixi 


d,hstbuf 




265 




dad 


d 


;hl = host address 


266 




xchg 




;now in DE 


267 




Ihld 


dmaadr 


;get/put CP/M data 


268 




mvi 


c,128 


; length of move 
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269! 

270! 

27l! 

272: 

273! 

274! 

275: 

276: 

277: 

278: 

279: 

280: 

281: 

282: 

283; 

284: 

285: 

286: 

287: 

288: 

289: 

290: 

291 

292 

293: 

294; 

295; 

296; 

297; 

298; 

299; 

300; 

301: 

302: 

303: 

304: 

305: 

306: 

307: 

308: 

309: 

310! 

311: 

312: 

313: 

314: 

315: 

316: 

317: 

318 

319 

320: 



Ida 


readop 


ora 


a 


jnz 


rwmove 



rwmove 



;which way? 
;skip if read 



write operation, mark and switch direction 

mvi a,l 

sta hstwrt ;hstwrt = 1 

xchg ;source/dest swap 



;C initially 128, DE is source, HL is dest 

Idax d ;source character 

inx d 

mov m,a ;to dest 

inx h 

dcr c ;loop 128 times 

jnz rwmove 

data has been moved to/from host buffer 

Ida wrtype ;write type 

cpi wrdir ; to directory? 

Ida erflag ;in case of errors 

rnz ;no further processing 



clear host buffer for directory write 

ora a ;errors? 

;skip if so 

a ;0 to accum 

hstwrt ;buffer written 
wr itehst 
erflag 



rnz 

xra 

sta 

call 

Ida 

ret 



***************************************************** 

* * 

* Utility subroutine for 16-bit compare * 

i(icifificicicicicic*i(ieicici(ieicici<icicicici<ic*ie*icicicicificicici(icici(i(i(icicicici(icicici(* 

sektrkcmp: 

;HL = .unatrk or .hsttrk, compare with sektrk 

xchg 

Ixi h, sektrk 

Idax d ;low byte compare 

cmp m ; same? 

rnz ;return if not 
; low bytes equal, test high Is 

inx d 

inx h 

Idax d 

cmp m ;sets flags 

ret 
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321; 

322! 

323; 

324; 

325; 

3 26; 

327; 

328; 

329 

330; 

331; 

332: 

333; 

334; 

335; 

336; 

337; 

338; 

339 

340; 

341; 

342: 

343; 

344; 

345; 

346; 

347; 

348; 

349; 

350; 

351; 

352; 

353; 

354; 

355; 

356; 

357; 

358; 

359; 

360; 

361; 

362; 

363; 

364; 

365: 

366; 

367; 

368: 

369; 

370: 



***************************************************** 

* * 

* WRITEHST performs the physical write to * 

* the host disk, READHST reads the physical * 

* disk. * 

* * 

***************************************************** 

writehst: 

jhstdsk = host disk #, hsttrk = host track #, 
;hstsec = host sect #. write "hstsiz" bytes 
;from hstbuf and return error flag in erf lag. 
;return erflag non-zero if error 
ret 

/ 

readhst: 

;hstdsk = host disk #, hsttrk = host track #, 
;hstsec = host sect #. read "hstsiz" bytes 
;into hstbuf and return error flag in erflag, 
ret 

* Unitialized RAM data areas * 

i<icicicieicicicicifi(icic*i(icicici(icicifificici(i(icicicicicisicici(i(^fe*i(ic'kic'kicicicic-kici(i( 



sekdsk: ds 

sektrk: ds 

seksec: ds 

• 

hstdsk: ds 

hsttrk: ds 

hstsec: ds 

sekhst: ds 

hstact: ds 

hstwrt: ds 

unacnt: ds 

unadsk: ds 

unatrk: ds 

unasec: ds 



erflag : 
rsflag : 
readop: 
wrtype: 
dmaadr : 
hstbuf: 



ds 
ds 
ds 
ds 
ds 
ds 



1 
2 
1 

1 
2 

1 

1 
1 
1 

1 
1 

2 
1 

1 
1 
1 
1 
2 
hstsiz 



seek disk number 
seek track number 
seek sector number 

host disk number 
host track number 
host sector number 

seek shr secshf 
host active flag 
host written flag 

unalloc rec cnt 
last unalloc disk 
last unalloc track 
last unalloc sector 

error reporting 
read sector flag 
1 if read operation 
write operation type 
last dma address 
host buffer 
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371; 
372; 
373i 
374; 
375; 
376; 



***************************************************** 

* * 

* The ENDEF macro invocation goes here * 

* * 

***************************************************** 
end 
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APPENDIX H 



ADDENDUMS 
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APPENDIX H-1 



HARDWARE ADDENDUMS 



APPENDIX H-2 
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SOFTWARE ADDENDUMS 



APPENDIX J 



Apiiehcl 



CUSTOMER INFORMATION 



APPENDIX J-1 
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SERVICING PROCEDURES 



Your SuperBrain II Video Terminal is warranted to the original purchaser for 90 days from date of 
shipment. This warranty covers the adjustment or replacement, F.O.B. Intertec's plant in 
Columbia, South Carolina, of any part or parts which in Intertec's judgment shall disclose to have 
been originally defective. A complete statement of your warranty rights is contained on the inside 
bacl< cover of this manual. 

To qualify for receipt of future technical documentation updates, please complete the Warranty 
Registration Form (contained in this section) and return it to Intertec Data Systems within 10 days 
of receipt of this equipment. Be sure to include the serial number of the specific terminal you are 
registering. The serial number of your terminal can be found on the right hand side of the rear I/O 
panel (looking from the rear). A Customer Comment Card is also enclosed for your convenience if 
you desire to make comments regarding the overall operation and/or adaptability of the 
SuperBrain II to your particular application. 

IF SERVICE IS EVER REQUIRED: 



If you should ever encounter difficulties with the use or operation of this terminal, contact the 
supplier from whom the unit was purchased for instructions regarding the proper servicing 
techniques. Service procedures differ from dealer to dealer, but most Intertec authorized service 
dealers can provide local, on-site servicing of this equipment on a per-call or maintenance 
contract basis. Plus, a wide variety of service programs are available directly from the factory, 
including extended warranty, a module exchange program, and on-site maintenance from a wide 
variety of locations within the U.S. 

Contact our Customer Services Department at the factory for rates and availability if you desire to 
participate in one of these programs. If you are not covered under one of the programs 
described above and service cannot be made available through your local supplier, contact 
Intertec's Customer Services Department at (803) 798-9100. Be prepared to give the following 
information when you call: 

1 . The serial number of the defective equipment. If you are returning individual modules to the 
factory for repair, it will be necessary to have the serial number of the individual modules 
also. The serial number of the entire terminal may be found on the right hand side of the rear 
I/O panel (looking from the rear). Module serial numbers are listed on white stickers placed in 
conspicuous locations on each major module or subassembly of the terminal. NOTE: 
Individual modules cannot be returned to the factory for repair unless you originally 
purchased your unit from the factory. If your unit was purchased through a Dealer or OEM 
vendor, and you desire factory repair, then the entire terminal must be returned. 

2. The name and location of the Dealer and/or Agent from whom the unit was purchased. 

3. A complete description of the alleged failure (including the nature and cause of the failure if 
readily available). 

The Customer Services Department will issue you a Return Material Authorization Number (RMA 
Number) which will be valid for a period of 30 days. This RMA Number will be your official 
authorization to return equipment to IDSC for repair only. The Customer Services Department will 
also give you an estimate, if requested, of the time it should take to process and repair your 
equipment. Turnaround time on repairs varies depending on workloads and availability of parts, 
but normally your equipment will be repaired and returned to you within 10 working days of its 
receipt. If your repair is urgent, you may authorize a special $50 Emergency Repair fee and have 
your equipment repaired and returned within no more than 48 hours of its receipt at our Service 
Center. Ask the Customer Services Department for more information about this program. 
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SERVICING PROCEDURES (continued) 



IMPORTANT: Any equipment returned to Intertec without an RMA Number will result in the 
equipment being refused and possible cancellation of your SuperBrain II warranty. Also if your 
RMA Number expires, you must request a new number. Equipment arriving at Intertec bearing 
an expired RMA Number will also be refused. 

After securing an RMA Number from the Customer Services Department, return the specified 
modules and/or complete terminals to Intertec, freight prepaid, at the address below. NOTE: The 
RMA Number must be plainly marked and visible on your shipping label to prevent the 
equipment from being refused at Intertec's Receiving Department. 

ATTN: SUPERBRAIN SERVICE CENTER 
Intertec Data Systems Corporation 

2300 Broad River Road 
Columbia, South Carolina 29210 

To aid our technicians in troubleshooting and correcting your reported malfunction, please 
complete an Intertec Equipment Malfunction Report (contained in this section) and enclose it with 
the equipment you intend to return to the factory. 

Be sure a declared value equal to the price of the unit is shown on the Bill of Lading, Express 
Receipt or Air Freight Bill, whichever is applicable. Risk of loss or damage to equipment during 
the time it is in transit either to or from Intertec's facilities is your sole responsibility. A declared 
value must be placed on your Bill of Lading to insure substantiation of your freight claim if 
shipping damage or loss is incurred. 

All equipment returned to an Intertec Service Center must be freight prepaid. Equipment not 
prepaid on arrival at Intertec's Receiving Department cannot be accepted. Upon repair of 
equipment under warranty, it will be returned to you freight prepaid, via UPS or equivalent ground 
transportation. All repaired equipment not covered by warranty will be returned, F.O.B. the 
factory in Columbia, South Carolina, via UPS or equivalent ground transportation unless you 
specify otherwise. 

INSTRUCTIONS FOR HANDLING LOST OR DAMAGED EQUIPMENT 

The goods described on your Packing Slip were delivered to the Transportation Company at 
Intertec's premises in complete and good condition. If any of the goods called for on this Packing 
Slip are short or damaged, you must file a claim WITH THE TRANSPORTATION COMPANY FOR 
THE AMOUNT OF THE DAMAGE AND/OR LOSS. 

IF LOSS OR DAMAGE IS EVIDENT AT TIME OF DELIVERY: 

If any of the goods called for on your Packing Slip are short or damaged at the time of delivery, 
ACCEPT THEM, but insist that the Freight Agent make a damaged or short notation on your 
Freight Bill or Express Receipt and sign it. 

IF DAMAGE OR LOSS IS CONCEALED AND DISCOVERED AT A LATER DATE: 

If any concealed loss or damage is discovered, notify your local Freight Agent or Express Agent 
AT ONCE and request him to make an inspection. This is absolutely necessary. Unless you do 
this, the Transportation Company will not consider your claim for loss or damage valid. If the 
agent refuses to make an inspection, you should draw up an affidavit to the effect that you notified 
him on a certain date and that he failed to make the necessary inspection. 
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SERVICING PROCEDURES (continued) 



After you liave ascertained tine extent of the loss or damage, ORDER THE REPLACEMENT PARTS 
OR COMPLETE NEW UNITS FROM THE FACTORY. We will ship them to you and bill you for the 

cost. This new invoice will then be a part of your claim for reimbursement from the Transportation 
Company. This, together with other papers, will properly support your claim. 

IMPORTANT: The claims adjustment procedure for UPS shipments varies somewhat from the 
procedure listed above for regular motor and air freight shipments. If your equipment was 
shipped via UPS and sustained either damage or loss, the UPS representative in your area must 
initiate the claim by inspecting the goods and assigning a freight claim number to the damaged 
equipment The representative will attach a "Call Tag" to the outside of the equipment box which 
will be your authorization to return the merchandise to our factory for claim adjustment. Upon 
receipt of this damaged equipment, we will perform the necessary repairs, process the 
appropriate paperwork with UPS and return the equipment to you. Please allow time for 
processing of any type claim. Normal time for proper processing of a UPS claim is 15-30 working 
days. 

Remember, it is extremely important that you do not give the Transportation Company a clear 
receipt if damage or shortages are evident upon delivery. It is equally important that you call for 
an inspection if the loss or damage is discovered later. DO NOT, UNDER ANY CIRCUMSTANCES, 
ORDER THE TRANSPORTATION COMPANY TO RETURN SHIPMENT TO OUR FACTORY OR 
REFUSE SHIPMENT UNLESS WE HAVE AUTHORIZED SUCH RETURN. 

ADDITIONAL TECHNICAL DOCUMENTATION 

Detailed technical documentation (i.e., schematics) describing the operation of the SuperBrain II 
Video Terminal and the electrical interconnection of its various modules is available at nominal 
cost directly from Intertec Data Systems Corporation. However, due to the confidentiality of this 
technical information, it will be necessary to sign and return the Documentation Non-Disclosure 
Agreement (appearing on the next page) denoting your concurrence with its terms and 
conditions. 

The handling and processing costs of SuperBrain II technical documentation is $50. Due to the 
large amount of requests being processed and the relatively small handling costs involved, we 
must request that you enclose payment ($50) upon return of your Non-Disclosure Agreement. 
Normally the documents will be mailed to you within 1 5 to 30 days after receipt of your payment 
and a signed copy of the Agreement. (IMPORTANT: The technical documentation will be mailed 
to the address listed at the top of the Non-Disclosure Agreement.) For prompt processing of your 
documentation request, please forward your signed agreement and payment to: 

Customer Services Department 
Intertec Data Systems Corporation 

2300 Broad River Road 
Columbia, South Carolina 29210 

NOTE: Formal technical documentation for the SuperBrain II will be sent to you normally within 
10-15 days of receipt of your payment and signed Non-Disclosure Agreement. 

IMPORTANT: Payment must accompany your Non-Disclosure Agreement. Agreements sent to us 
without payment will be discarded without notice. 
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INTE^TEC SUPERBRAIN II DOCUMENTATION NON-DISCLOSURE AGREEMENT 
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SYSTEMS 



(fi' Corporate Headquarters: 2300 Broad River Road, Columbia, South Carolina 29210 • 803/798-9100 • TWX: 810-666-2115 



YOUR COMPANY NAME 
ADDRESS 



THIS AGREEMENT MADE BETWEEN INTERTEC 
DATA SYSTEMS CORPORATION AND THE ORGANI- 
ZATION AND/OR PERSONS LISTED AT THE RIGHT 
AND BECOMES EFFECTIVE ON THE DATE SPECI- 
FIED BELOW. 

(PLEASE PRINT CLEARLY. DOCUMENTS WILL BE 
MAILED TO THE ADDRESS AT RIGHT) 



For and in consideration of receiving confidential docunnentation on tine SuperBrain 1 1™ line of terminals 
manufactured by INTERTEC DATA SYSTEMS CORPORATION (hereinafter called INTERTEC) at the date 
hereof, the undersigned hereby agrees with INTERTEC as follows: 



CITY & STATE. 
TELEPHONE _ 
YOUR NAME . 



(1) The undersigned acknowleges that formulae, 
programs, manufacturing processes, devices, 
techniques, plans, methods, drawings, blueprints, 
reproductions, data tables, calculations and com- 
ponents were designed and developed by INTERTEC 
at great expense and over lengthy periods of time, 
and the same are secret and confidential, are unique 
and constitute the exclusive property and trade 
secrets of INTERTEC, and that any use of such prop- 
erty and trade secrets by the undersigned other than 
for the sole benefit of INTERTEC would be wrongful, 
tortiuous and would cause irreparable injury to 
INTERTEC. 

(2) The undersigned shall not at any time, without 
the express written consent of the Board of Di- 
rectors of INTERTEC, publish, disclose, use or di- 
vulge to any person, firm or corporation, directly or 
indirectly, or use for his own benefit or the benefit of 
any person, firm, or use other than to effect repair of 
INTERTEC manufacturing equipment, and property 
above described, trade secrets or confidential infor- 
mation of INTERTEC, its subsidiaries and its af- 
filiates learned or obtained by its subsidiaries and its 
affiliates learned or obtained by him from INTERTEC, 
including, but not limited to the information and 
things set forth in paragraph 1 hereinabove. 

(3) This agreement shall be binding upon the 
undersigned, his personal representatives, succes- 
sors and assigns, and shall run to the benefit of 
INTERTEC, its successors and assigns. 



(4) Upon termination of the association of the 
undersigned with INTERTEC or its subsidiaries, the 
undersigned shall promptly deliver to INTERTEC all 
drawings, blueprints, reproductions, manuals, let- 
ters, notes, notebooks, reports, data, tables, calcula- 
tions or copies thereof, components,- programs, and 
any and all other secret and confidential property of 
INTERTEC, its subsidiaries and affiliates, including, 
but not limited to, all of the property set forth in 
paragraph 1 hereinabove which are in the posses- 
sion or under the control of the undersigned. 

(5) The undersigned hereby acknowledges and 
agrees that in the event of any violation hereof, 
INTERTEC shall be authorized and entitled to obtain 
from any court of competent jurisdiction preliminary 
and permanent injunctive relief as well as equitable 
accounting of all profits or benefits arising out of 
such violation which rights or remedies shall be 
cumulative and in addition to any rights or remedies 
to which INTERTEC may be entitled and that the 
undersigned shall further be directly liable for any 
and all reasonable attorney's fees incurred by 
INTERTEC to enforce this Agreement against the 
undersigned in a court of law. 

(6) The foregoing understanding shall apply to 
any subsequent meeting and/or communications 
between INTERTEC and the above mentioned or- 
ganization relating to the same subject manner, 
unless modified in writing as to any such subsequent 
meetings and/or communications. 



We would appreciate your signing and returning to us, prior to the release of INTERTEC product 
documentation, the original copy of this agreement denoting your concurrence with the foregoing provi- 
sions. 



AGREED TO: 



(YOUR NAME OR COMPANY - PLEASE PRINT) 

YOUR SIGNATURE: 

In addition to the terms listed above, I further certify that I am duly 
authorized to sign this document on behalf of the organization and/or 
persons requesting that this imformation be supplied by INTERTEC. 

YOUR NAME: 



INTERTEC DATA SYSTEMS CORPORATION 

SIGNATURE: 



YOUR TITLE: 



TODAY'S DATE:. 



DATERCVD 



FOR OFFICE USE ONLY 



PROCESSED BY: 



OTHER RELEASES 



DATE 



INVOICE NO. 



BE SURE TO INCLUDE YOUR SERIAL NUMBER HERE. 

SERIAL NO. 



I INTE^TEC 
DATA 
SYSTEMS 

3® Corporate Headquarters: 2300 Broad River Road, Columbia, South Carolina 29210 • 803/798-9100 • TWX: 810-666-2115 



SUPERBRAIN II LIMITED WARRANTY REGISTRATION FORM 

IMPORTANT: This form should be completed within ten days of receipt of your SuperBrain 
Video Computer System and returned to Intertec at the following address: 

Intertec Data Systems Corporation 
2300 Broad River Road 
Columbia, South Carolina 29210 

Attn: Warranty Registration Department 

All warranty liability is limited to that expressed in most recent edition of the SuperBrain 
Video Computer User's Manual as published by Intertec Data Systems Corporation. 



******** 



Date Received: 

Company: 

Name: 

Title: 



Purchased from:. 



Address 
City: 



Address 
City: 



Telephone: _1_ 



Sales Agent: 



Country: 



Telephone: J_ 



Order Placed On: 
Price Paid: 



******** 



Where did you first hear about the SuperBrain? From a D Magazine D Dealer D Friend 



Why did you decide to purchase the SuperBrain? D Features D Price DAppearance 



Was the Dealer and/or Sales Agent knowlegeable about the SuperBrain? DYES DNO 
Please explain. 



Questions on the reverse side must be completed to validate your warranty 




Were you introduced to any other I ntertec products? D YES DNO (if yes, please 
indicate otiier products whicii were mentioned.) 



Are you aware of other Intertec products? D YES D NO (If yes, which ones?) 



What other nnicrocumputer related products will you be purchasing in the next 12 months? 
D Video Terminals D Printers (matrix) D Printers (character) D Disk Systems D Other 



What is your application for the SuperBrain? D Business D Scientific D Educational D Other 



What are your comments in general concerning the overall operation of the SuperBrain-? 
n Outstanding D Excellent D Good D Average D Unsatisfactory 



Would you like to be placed on our mailing lists? D YES D NO 

May we use your name as a favorable reference for other customers in your area desiring to 
purchase a SuperBrain? D YES D NO 

Thank you for purchasing the SuperBrain II Video Computer System. If we may be of further 
assistance to you, please contact our Customer Service Department at the address on the 
reverse side of this form. 




INTE^TEC EQUIPMENT MALFUNCTION REPORT 
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THIS EQUIPMENT PURCHASED FROM: 



Dealer Name: 
City «Sc State 



Address 



Telephone Area_L 



Dear Customer: 

We are trying to manufacture the most reliable product possible. You would do us a great courtesy by com- 
pleting this form should you experience any failures. Enclose this form with the equipment you intend to 
return to the dealer or factory for service. (Additional copies of this form available upon request.) 



1. 



Type Unit. 



.Serial No._ 



Module (if applicable). 



Component failed (if available, include Name and Number) . 



3. Description of failure (include cause of failure if readily available) 



4. Approximate hours/days of operation to failure 

5. Failure occurred during: 

D Initial Inspection D Customer Installation D Field Use 

6. Personal Comment: 



Your Name 
City & State. 
Date 



Address 



_Zip_ 



_Phone( . 



.Signed. 



Return this form and equipment to your local dealer or to the factory at the address below. 

ATTN: SUPERBRAIN SERVICE CENTER 
Intertec Data Systems Corporation 

2300 Broad River Road 
Columbia, South Carolina 29210 
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Our past and present customers are directly responsible for the evolution of the SuperBrain 
as you see it presented in this manual. Before Intertec began research and development on the 
SuperBrain, an extensive user survey was conducted to ascertain optimum video computer 
price/performance ratios to enable us to capture a major portion of the video computer market. In 
order that we continue with our commitment to excellence in engineering, production and 
marketing, we would appreciate your comments below regarding your overall opinion of the 
SuperBrain. All comments are given careful consideration in future product design and become 
the property of Intertec Data Corporation. 



(1) What are your comments concerning the overall appearance of the SuperBrain? (You may 
want to comment on color, size and construction.) 



(2) What are your comments (in general) concerning the overall operation of the unit? 



(3) What features about the unit do you like best? 



(4) What features about the unit do you like least? 



Please see additional questions on the reverse side 




(5) Briefly describe your application for the SuperBrain. 



(6) What other microcomputer systems do you feel are comparable to the SuperBrain in both 
price and performance? 



(7) What changes and/or modifications to the SuperBrain could be made to render it more 
suited to your application? 



(8) Your candid comments regarding the operation of and application for the SuperBrain are 
greatly appreciated. Address your comments and/or suggestions to: 

PRODUCT SERVICES MANAGER 
Intertec Data Systems 
2300 Broad River Road 
Columbia, South Carolina 29210 

(9) If you desire to be contacted by our service, marketing or technical staff regarding these 
comments, please give us your complete name, address and phone number below. (This in- 
formation is optional.) 

Company Name 

Address ■ : ^ 

City, State & Zip . 

Contact: 



Phone: AREA ( ) . EXT. 



I would like to be contacted by your: D Marketing D Technical D Service Department 




INTE^TEC DOCUMENT REVIEW FORM 

DATA 
SYSTEMS 
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In order to insure that you are provided with a document that will satisfy all of your infornnation re- 
quirements as well as one that is error free and easy to use, we would like to ask you to supply us 
with any comments, suggestions, or errors you have found. The space below is provided for this 
input. Return the completed form to: 

ATTN: TECHNICAL SERVICES MANAGER 
Intertec Data Systems Corporation 

2300 Broad River Road 
Columbia, South Carolina 29210 



STATEMENT OF LIMITED WARRANTY 

For ninety (90) days from the date of shipment from our manufacturing plant at 2300 Broad River Road, Columbia, South Carolina, Intertec warrants, to 
., the original purchaser only, that its products, excluding software products, will be free of defective parts or components and agrees to replace or repair any 
defective component which, in Intertec's judgement, shall disclose to have been originally defective. Intertec neither offers nor implies any warranty 
whatsoever on any software products. Furthermore, Intertec's obligations under this limited warranty are subject to the following conditions: 

LIMITED WARRANTY REPAIRS 

Unless authorized by written statement from Intertec, all repairs must be done by Intertec at our plant in Columbia, South Carolina. Return of any and all 
parts and/or equipment must be freight prepaid and accompanied by an Intertec Return Material Authorization number which must be clearly visible on the 
customer's shipping label. Return of parts or equipment contrary to this policy shall result in the material being refused, and the customer being invoiced 
for any replacement parts, if any were previously issued, at Intertec's standard prices. 

When making repairs or replacing parts in accordance with this limited warranty, Intertec reserves the right to alter and/or modify specifications of this 
equipment. 

Upon completion of the repairs, Intertec will return the equipment, freight prepaid, directly to the customer from whom it was sent via UPS or equivalent 
ground transportation. 

Authorization to return equipment for repair can be obtained by writing Intertec at the address stated herein or by calling our Customer Service 
Department at 803/798-9100. 

In the event Intertec shall authorize repair of its equipnnent, in writing, by an authorized repair agent, then Customer shall bear all shipping, packing, 
inspection and insurance costs necessary to effectuate repairs under this warranty. 

EXCLUSIONS 

The Limited Warranty provided by Intertec Data Systenns Corporation does hot include: 

(a) Any damage or defect caused by injuries received in shipment or any damage caused by unauthorized repairs or adjustments. The risk of loss or 
damage to the equipment shall pass to the Customer upon delivery by Intertec to the carrier at Intertec's premises. 

(b) Repair, damage or increase in service time caused by failure to continually provide a suitable installation environment including, but not limited to, the 
failure to provide, or the failure of, adequate electrical power, air-conditioning, or humidity control. 

(c) Repair, damage or increase in service time caused by accident or disaster, which shall include, but not be limited to, fire, flood, water, wind, lightning, 
transportation neglect, misuse and alterations, which shall include, but not be limited to, any deviation from the original physical, mechanical or electrical 
design of the product. 

(d) Any statements made about the equipment by salesman, dealers or agents unless such statements are in a written document signed by an officer of 
Intertec Data Systems Corporation. Such statements do not constitute warranties, shall not be relied on by the buyer, and are not part of the contract for 
sale. 

(e) Any damage arising out of any application for its products other than for normal commercial and industrial use, unless such application is, upon 
request, specifically approved in writing by Intertec. Intertec products are sophisticated data processing units and are not sold or distributed for personal, 
family or household purposes. 

This Class A equipment generates, uses, and can radiate radio frequency energy and if not installed and used in accordance with the instructions 
manual, may cause interference to radio communications. As temporarily permitted by regulation it has not been tested for compliance with the limits for 
Class A computing devices pursuant to Subpart I of Part 15 of FCC Rules, which are designed to provide reasonable protection against such interference. 
Operation of this equipment in a residential area is likely to cause interference in which case the user at his own expense will be required to take whatever 
measures may be required to correct the interference. 

(f) Software, including either source code, object code, or any computer program used in connection with our equipment, whether purchased directly 
from Intertec or from an independent source. 

WAIVER OF ALL EXPRESS OR IMPLIED WARRANTIES 

Our limited warranty to repair or replace defective parts or components for ninety (90) days after date of shipment from our Columbia plant is being 
offered in lieu of all express or implied warranties. 

INTERTEC MAKES NO EXPRESS WARRANTY OTHER THAN THE LIMITED WARRANTY SET FORTH ABOVE, CONCERNING THIS PRODUCT OR ITS 
COMPONENTS, NOR DO WE IMPLIEDLY WARRANT ITS MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. 

All statements, technical information and recommendations contained in this document and related documents are based on tests we believe to be 
reliable, but the accuracy or completeness thereof is not guaranteed. 

THE FOREGOING LIMITED WARRANTIES ARE IN LIEU OF ALL OTHER WARRANTIES, EXPRESS OR IMPLIED, EXCEPT AS TO CONSUMER GOODS IN 
WHICH CASE THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE APPLY ONLY FOR THE PERIOD OF 
THE LIMITED WARRANTY. 

PURCHASERS OF CONSUMER PRODUCTS SHOULD NOTE THAT SOME STATES DO NOT ALLOW FOR THE EXCLUSION OF CONSEQUENTIAL 
DAMAGES OR THE LIMITATION OR THE DURATION OF IMPLIED WARRANTIES SO THE ABOVE EXCLUSION AND LIMITATION MAY NOT BE 
APPLICABLE. 

THIS LIMITED WARRANTY GIVES THE PURCHASER SPECIFIC LEGAL RIGHTS, AND THE PURCHASEFI MAY ALSO HAVE OTHER RIGHTS WHICH 
MAY VARY FROM STATE TO STATE. 

LIMITATION OF REMEDIES 

INTERTEC SHALL NOT BE LIABLE FOR ANY INJURY, LOSS OR DAMAGE, DIRECT OR CONSEQUENTIAL, TO PERSONS OR PROPERTY CAUSED 
EITHER DIRECTLY OR INDIRECTLY BY THE USE OR INABILITY TO USE ITS PRODUCT AND/OR DOCUMENTS. SUCH LIMITATION IN LIABILITY SHALL 
REMAIN IN FULL FORCE AND EFFECT EVEN WHEN INTERTEC MAY HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH INJURIES, LOSSES OR 
DAMAGES. 

Before purchasing or using, the Customer shall determine the suitability of Intertec's products and documents for his intended use and assumes all risk 
and liability whatsoever in connection therewith. 

THE LIMITED WARRANTY TO REPLACE OR REPAIR PARTS OR COMPONENTS FOR (90) DAYS IS THE EXCLUSIVE REMEDY PROVIDED TO THE 
CUSTOMER AND THE LIABILITY OF INTERTEC WITH RESPECT TO ANY OTHER CONTRACT, SALE OR ANYTHING DONE IN CONNECTION THEREWITH, 
WHETHER IN CONTRACT, IN TORT, UNDER ANY WARRANTY, OR OTHERWISE. SHALL NOT EXCEED THE PRICE OF THE PART OR COMPONENT ON 
WHICH SUCH LIABILITY IS BASED. 

Rights under this warranty are not assignable without the express prior consent, in writing, of Intertec Data Systems Corporation and, regarding the 
terms of such consent in writing, such assignee shall have no greater rights than his assignor. 

In the event the Customer has any problem or complaints arising out of any breach of our limited warranty, including a failure to make repairs in 
accordance with this warranty, or unsuccessful repair attennpts by an authorized repair facility, the Customer is encouraged to inform Intertec, in writing, of 
his or her problem or complaint. Any such writing should be addressed to Intertec Data Systems Corporation at 2300 Broad River Road, Columbia, South 
Carolina 29210, and should be marked with the phrase "Warranty Claim." 
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